Utilizando envios automáticos de whatsapp via API

Envio de Mensagens via API Oficial do WhatsApp (Automação de Campanhas)

Este documento descreve o processo de configuração e envio de mensagens através de automação de campanhas utilizando primariamente um canal oficial do WhatsApp (Meta).

Pré-requisitos

Antes de iniciar, é necessário que:

• O canal de WhatsApp já esteja devidamente configurado no sistema.

• O template de mensagem esteja aprovado pela Meta.

⚠️ Importante

A API oficial da Meta não permite o envio de mensagens livres.
Somente é permitido o envio de templates previamente aprovados pela moderação da Meta.

Além disso:

A criação do template deve obrigatoriamente ser feita através do sistema da Tallk.me.
Não crie templates diretamente pela Meta ou por BSPs parceiros.

1. Criação do Template

O primeiro passo é criar um template de mensagem dentro da plataforma.

Após a criação, o template será enviado para aprovação da Meta.

2. Criação da Campanha

Após a criação do template, é necessário criar uma campanha de envio.

Caso o template utilize variáveis, será necessário informar a correlação entre a ordem da variável (1ª,2ª,3ª...) e o valor que ela deve assumir (dentre as opções disponíveis) no momento da criação da campanha e posteriormente os valores devem ser passados no payload da URI apropriada.

3. Envio das Mensagens

Depois que o template e a campanha estiverem configurados, existem duas formas de adicionar contatos para envio:

• Importação de lista de contatos pela interface

• Envio automático através da API

Neste documento vamos tratar somente os dois métodos disponíveis na API.

Localização na plataforma de informações importantes:

Método 1 — Template sem Variáveis

Caso o template não utilize variáveis, é possível inserir o contato na campanha através de uma requisição HTTP GET.

Exemplo de URI

Parâmetros da URL

Método 2 — Template com Variáveis

Caso o template utilize variáveis, é necessário enviar os valores dessas variáveis no payload da requisição.

Neste caso deve ser utilizada uma requisição HTTP POST.

Endpoint

Exemplo de Payload da Requisição

{
   "txtmsg":"Texto da mensagem",
   "id_wpp":1234,
   "email_dest":"email@email.com.br",
   "numero_dest":"1133332222",
   "id_campanha":123456,
   "assunto":"Alerta",
   "info_contato":{
      "documento":"01234567890",
      "nome":"Fulano de tal",
      "telefone1":"1133332222",
      "telefone2":"",
      "telefone3":"",
      "email":"email@email.com.br",
      "endereco":"Rua A",
      "bairro":"Centro",
      "cep":"11200000",
      "cidade":"Cidade",
      "estado":"UF",
      "pais":"BR",
      "geral1":"Informação Genérica 1",
      "geral2":"Informação Genérica 2",
      "geral3":"Informação Genérica 3",
      "geral4":"Informação Genérica 4",
      "geral5":"Informação Genérica 5"
   }
}

Descrição dos Campos

Campos Principais

Variáveis do Contato (info_contato)

As variáveis utilizadas nos templates são enviadas dentro do objeto info_contato.

⚠️ Observação:

Caso a variável PRIMEIRO_NOME seja utilizada no template, o sistema automaticamente extrai o primeiro nome a partir do campo nome.