Pular para o conteúdo principal

Broadcast Plugin - 1ª Versão do Plugin

Take Blip
  • 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

Na página inicial, clique na seta ao lado do nome do bot e selecione a opção Configuração.

wa-plugin1.png

Em configurações básicas, clique no link aqui ao final da página para acessar as configurações avançadas.

wa-plugin2.png

No pop-up exibido, clique em Continuar.

wa-plugin3.png

Clique em Adicionar.

wa-plugin4.png

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/” }}

 

wa-plugin5.png

Clique no check (✓) para salvar as configurações.

wa-plugin6.png

Recarregue a página pressionando F5.

Clique nas reticências (...) do menu central e selecione Broadcast.

wa-plugin7.png

Antes de abrir o plugin pela primeira vez, leia e aceite os termos de uso.

wa-plugin8.png

O plugin deverá ser exibido, como na imagem abaixo:

wa-plugin9.png

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.

wa-plugin10.png

Clique em um dos modelos de mensagem cadastrados, e copie o valor do campo Namespace.

wa-plugin11.png

Este valor representa o identificador do WhatsApp Business Account.

Flow ID

Selecione builder, no próprio bot ou no bot principal.

wa-plugin12.png

Selecione a engrenagem no canto esquerdo da tela.

wa-plugin13.png

Procure pela opção Identificador do fluxo, clique para expandi-la e copie o valor exibido.

wa-plugin14.png

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.

wa-plugin15.png

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

wa-plugin16.png

É 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.

wa-plugin17.png

State ID

No Builder, clique com o botão direito no bloco desejado e selecione Copiar Id.

wa-plugin18.png

Individual

O envio de notificações ativas pode ser feito para um telefone específico na aba "Individual".

wa-plugin19.png

  • 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.

wa-plugin20.png

  • 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

 

Powered by Zendesk