Broadcast Plugin - 1ª Versão do Plugin Take Blip 1 de julho de 2021 13:07 Atualizado O plugin de Broadcast do WhatsApp é uma alternativa ao envio de mensagens ativas, que pode ser feito de forma manual por um usuário do Blip. A nova versão já está disponível😉 É necessário ter o WhatsApp ativado no bot, sendo um cliente Starter, Business ou Enterprise. Neste artigo explicamos Instalação do plugin de Broadcast Configurações gerais Configure seus templates Envio individual Envio por planilha Instalação do plugin de Broadcast Na página inicial, clique na seta ao lado do nome do bot e selecione a opção Configuração. Em configurações básicas, clique no link aqui ao final da página para acessar as configurações avançadas. No pop-up exibido, clique em Continuar. Clique em Adicionar. Preencha os campos com as seguintes informações: Domínio Chave Valor postmaster@portal.blip.ai Plugins {“broadcast-plugin”: {“name”:”Broadcast”,”url”:”https://blip-plugin-broadcast.cs.blip.ai/” }} Clique no check (✓) para salvar as configurações. Recarregue a página pressionando F5. Clique nas reticências (...) do menu central e selecione Broadcast. Antes de abrir o plugin pela primeira vez, leia e aceite os termos de uso. O plugin deverá ser exibido, como na imagem abaixo: Para utilizar o plugin pela primeira, siga os próximos passos em Configurações gerais. Configurações gerais Nesta página é possível fazer a configuração do plugin, com os seguintes campos: Namespace: identificador do WhatsApp Business Account - a conta que permite a utilização das features da WhatsApp Business API. Master State: {{identificador do bot principal}} @msging.net Flow ID: identificador do fluxo do bot. Organization: nome da organização a qual o bot pertence Separator: separador do arquivo no formato .csv (Comma-separated values) ao utilizar a planilha. Por padrão, este valor é a vírgula (","), mas este valor deve ser alterado de acordo com o arquivo utilizado. Alguns programas utilizam outros separadores, como o ponto-e-vírgula (";") ou o separador horizontal ("|"). O Microsoft Excel, nas configurações padrões do Brasil, utiliza o ponto-e-vírgula (";"). Namespace Nas reticências do menu central, selecione Conteúdos. Clique em um dos modelos de mensagem cadastrados, e copie o valor do campo Namespace. Este valor representa o identificador do WhatsApp Business Account. Flow ID Selecione builder, no próprio bot ou no bot principal. Selecione a engrenagem no canto esquerdo da tela. Procure pela opção Identificador do fluxo, clique para expandi-la e copie o valor exibido. Organization Na tela principal, caso não exista uma opção de contratos como na imagem abaixo, é porque o bot não está em uma organização. Caso a opção exista, clique na caixa exibida. A organização será o valor antes de blip.ai. No caso da imagem, o valor é sustentacao.blip.ai, então a organização é sustentacao. Outra forma é verificando a URL na qual você está acessando o Blip. No nosso exemplo, a URL é https://sustentacao.blip.ai/application/detail/broadcastroteador/home, portanto a organização é sustentacao. Configure seus templates É possível mudar o estado do usuário ao fazer o envio de uma mensagem ativa pelo plugin de broadcast. Desta forma, ao responder o conteúdo enviado, a interação não seguirá do Inicio ou do bloco em que o usuário estava previamente, mas de um determinado ponto do fluxo. Template: identificador do template aprovado. State ID: identificador do bloco. O bloco para qual o usuário será direcionado deve ser um bloco com espera de entrada do usuário, sem o envio de mensagens e/ou ações de entrada. State ID No Builder, clique com o botão direito no bloco desejado e selecione Copiar Id. Individual O envio de notificações ativas pode ser feito para um telefone específico na aba "Individual". Número do telefone: número para qual a mensagem ativa será ser enviada. Para números do Brasil, o formato é [DDD sem o zero][Numero de telefone]. Ex.: 31988889999 Caracteres não-números são removidos, portanto, (31) 98888-9999 é equivalente a 31988889999. Para todos os números, do exterior ou do Brasil, o formato é o MSISDN (número de telefone completo). Ex.: 5531988889999 Email que receberá o resultado (opcional): e-mail para qual será enviado um log com o resultado do disparo, com o motivo do erro em caso de falha. Template: modelo de mensagem já aprovado. Ordenar templates: selecione uma opção para alterar a ordem de exibição dos templates. Variável {{x}}: esses campos substituem as variáveis no modelo de mensagem. O envio da mensagem é feito ao clicar no botão Enviar. Nota: o envio de templates com mídia não é possível no envio individual. Para isso, utilize a Planilha. Planilha O envio de notificações pode ser feito vários usuários através de uma planilha no formato CSV. Além do disparo em massa, é possível acrescentar informações sobre o contato que podem ser utilizados no fluxo e exibidos no atendimento humano, e o disparo de templates com mídia. Enviar planilha...: selecione um arquivo .csv, contendo uma lista de telefones e variáveis. Mais informações sobre o formato abaixo. Nome da coluna de telefone na planilha: o título da coluna contendo a lista de telefones. Email que receberá o resultado (opcional): e-mail para qual será enviado um log com o resultado do disparo para cada um dos números, com o motivo do erro em caso de falha. Template: modelo de mensagem já aprovado. Ordenar templates: selecione uma opção para alterar a ordem de exibição dos templates. Formato da Planilha O plugin de broadcast aceita arquivos do tipo CSV (Comma-separated values), que são arquivos de texto com os valores separados por vírgulas , (ou outro caractere), formando uma planilha. Este é um formato disponível em todos os editores de planilhas, como o Excel ou o Google Sheets. Esta planilha deve conter uma coluna para a lista de telefones, e uma para cada variável, na ordem que aparecem no template. A primeira linha deve conter um título para cada uma delas. Ex.: Para a mensagem boasvindas. Oi, {{1}}. Boas-vindas a Take. É um prazer te ter conosco. O seu plano {{2}} acaba de ser aprovado. Telefone Nome Plano 31993490957 Raphael Business 69991579536 Carol Business 86991414021 Letícia Enterprise +15076401185 Alex Business Para o contato na primeira linha, será enviado para o telefone 31993490957 a seguinte mensagem: Oi, Raphael. Boas-vindas a Take. É um prazer te ter conosco. O seu plano Business acaba de ser aprovado. Extras de contato Os valores na planilha, além de serem utilizados para as variáveis do template, também são importados para o Blip, como atributos extras de contato. Ex.: ao fazer o envio da planilha acima, será criado o campo Plano com os valores da planilha para cada um dos contatos. Além disso, colunas com o título Nome e Email substituem os campos padrão. Mídia Caso o template utilizado contenha alguma mídia, o link para o conteúdo deve constar na segunda coluna. Telefone Link +15076401185 https://media.tenor.com/images/e88b43267a13dd1230da45a3a85ebf65/tenor.png 31993490957 https://media.tenor.com/images/e88b43267a13dd1230da45a3a85ebf65/tenor.png Artigos relacionados WhatsApp Broadcast - 2ª Versão do Plugin Como enviar notificações WhatsApp via API do Blip Como criar blocos no Builder