[Extensão] Como disparar mensagens ativas no WhatsApp pelo Smartico

1. Introdução

2. Funcionalidades

3. Pré-requisitos

4. Instalação e configuração

5. Exemplo de uso

6. Suporte

Descrição breve: Conecte as regras de automação do Smartico ao Blip e dispare mensagens de WhatsApp com templates aprovados, preenchidos com os dados que o Smartico envia por webhook.

Introdução

A extensão Smartico (iGaming): Disparo de mensagens integra a plataforma de automação Smartico ao Blip para enviar mensagens ativas de WhatsApp. Quando uma regra de automação dispara no Smartico, ela chama por webhook uma URL gerada pela extensão, e o Blip envia um template de WhatsApp aprovado já preenchido com os dados recebidos.

Por exemplo, ao criar uma regra que dispara após um jogador fazer um depósito, o Smartico envia o número do jogador e os dados do depósito para a URL da extensão. A extensão localiza esses valores no corpo da requisição, preenche as variáveis do template e envia a mensagem para o WhatsApp do jogador.

Funcionalidades

• Disparar mensagens de WhatsApp a partir das regras de automação do Smartico, por webhook.

• Enviar templates de WhatsApp já aprovados no bot.

• Preencher as variáveis do template com os dados enviados no corpo do webhook, usando a referência [body.campo].

• Preencher variáveis de mídia e de botão quando o template exige.

• Posicionar o contato em um bot e fluxo específicos após o disparo.

Suportada no seguinte canal: WhatsApp.

Pré-requisitos

• Um bot Roteador na Blip com o canal WhatsApp conectado, que será o remetente das mensagens.

• Pelo menos um template de WhatsApp aprovado nesse bot.

• Acesso ao módulo de Regras de Automação (Automation Rules) do Smartico.

• O número de cada destinatário em formato internacional, com sinal de +, DDI, DDD e número (por exemplo, +5511999999999).

Instalação e configuração

Instalar a extensão

1. Abra a página do Smartico na Blip Store e clique em Iniciar teste grátis.

2. Instale a extensão no seu bot e abra a extensão. Ela abre o assistente de configuração em três etapas: Configurar bot, Configurar template e Instalar automação. Não há passo de autenticação: toda a configuração é feita no assistente.

Configurar o bot que envia as mensagens

Na etapa Configurar bot, selecione em Bot roteador pai com whatsapp conectado o Roteador que tem o WhatsApp conectado e clique em Salvar e avançar. A extensão passa a usar o WhatsApp desse bot para enviar as mensagens. Se aparecer o aviso Whatsapp não reconhecido nesse bot, o bot selecionado não tem WhatsApp conectado e você precisa escolher outro.

Configurar o template e as variáveis

1. Na etapa Configurar template, abra Modelo de mensagem e selecione o template aprovado que será usado no disparo. A extensão mostra o corpo da mensagem para conferência.

2. Para cada variável do template (Variável {{1}}, Variável {{2}} e assim por diante), informe o valor que a preencherá. Para usar um dado dinâmico enviado pelo Smartico, escreva a referência [body.campo], onde campo é o nome exato do campo enviado no corpo do webhook. Por exemplo, [body.name] busca o valor do campo name no corpo da requisição.

3. Se o template tiver mídia ou botão, preencha os campos Link da mídia e Botão da variável.

4. Para posicionar o contato em um bot e fluxo após receber a mensagem, ative Posicionar usuário no bot e escolha o Bot e o Fluxo de destino. Este passo é opcional.

Nota: a quantidade de campos de variável segue o template selecionado. Se você trocar o template depois ou mudar a quantidade de variáveis dele, refaça a configuração e gere uma nova URL, para os campos continuarem correspondendo.

Variáveis dinâmicas do Smartico

As variáveis dinâmicas correspondem aos dados que você cria no campo Data das Regras de Automação do Smartico. Cada dado enviado no corpo do webhook vira um campo acessível na extensão por [body.nomeDaVariavel]. Crie no Smartico os dados que a mensagem precisa, por exemplo:

Na extensão, referencie cada dado no campo da variável correspondente. Os nomes devem ser idênticos aos campos enviados pelo Smartico:

[body.name] [body.orderNumber] [body.deliveryDate]

Gerar e copiar a URL de integração

Depois de configurar o template e as variáveis, a extensão gera a URL de integração automaticamente. Copie a URL e guarde para a próxima etapa.

Atenção: a URL carrega a chave de acesso da extensão. Não a compartilhe em locais públicos nem altere seus parâmetros manualmente, porque quem tiver a URL pode disparar mensagens pelo seu bot.

Configurar o webhook no Smartico

No módulo de Regras de Automação do Smartico:

1. Abra as Regras de Automação e adicione uma atividade do tipo Webhook.

2. Cole a URL gerada pela extensão no campo Webhook URL.

3. Selecione o método POST.

4. Defina o Content-Type como application/json.

5. No campo Data, crie as variáveis usadas na mensagem e um campo obrigatório phoneNumber com o número que receberá a mensagem, em formato internacional.

Campo obrigatório phoneNumber

O campo phoneNumber é obrigatório em todos os disparos e identifica o número que receberá a mensagem. Se ele não vier no corpo do webhook, a extensão rejeita a requisição; se o número for inválido, o disparo também falha. Envie o número em formato internacional, com +, DDI, DDD e número:

As demais variáveis (name, orderNumber, deliveryDate) preenchem o texto do template.

Exemplo de uso

Considere um template com três variáveis:

Olá, {{1}}. Seu pedido {{2}} tem entrega prevista para {{3}}.

No campo Data do Smartico:

Na extensão, mapeie cada variável para o campo correspondente:

• {{1}} recebe [body.name]

• {{2}} recebe [body.orderNumber]

• {{3}} recebe [body.deliveryDate]

O contato recebe no WhatsApp:

Olá, João Silva. Seu pedido 12345 tem entrega prevista para 10/09/2024.

Antes de ativar campanhas maiores, faça um teste com um número controlado e confirme que a mensagem chega no WhatsApp. Se não chegar, revise a URL, o método POST, o Content-Type e o campo phoneNumber. Acompanhe os retornos e os erros das primeiras execuções antes de liberar o disparo em massa.

Suporte

Em caso de dúvidas ou problemas com a extensão, fale com a gente pelo e-mail support@wiv.com.br.

Precisa de mais ajuda? Explore nossos conteúdos na Blip Academy ou Blip Community, assista a tutoriais no nosso canal do YouTube ou tire suas dúvidas em nosso canal de atendimento 😃