Utilizando envios automáticos
Abaixo
Envio seráde explicadoMensagens avia lógicaAPI Oficial do WhatsApp (Automação de Campanhas)
Este documento descreve o processo de configuração e envio de uma mensagemmensagens através de automação de campanhacampanhas usandoutilizando umaprimariamente APIum canal oficial do WhatsApp (Meta).
Pré-requisitos
Antes de whatsappiniciar, oficial.é necessário que:
-
EstamosOassumindo que a configuração docanal dewhatsappWhatsApp já estejaconcluído.devidamente configurado no sistema. -
O template de mensagem esteja aprovado pela Meta.
⚠️ Importante
PelaA API oficial da Meta,Meta não épermite possívelo enviarenvio qualquerde mensagem.mensagens Sólivres.
Somente é possívelpermitido enviaro envio de templates pré-previamente aprovados pela moderação da meta.OBS.:Meta.
Além disso:
A criação do template deve obrigatoriamente ser feita através do sistema da
tallk.Tallk.meé obrigatório..
Nãocriarcriediretotemplates diretamente pela Meta ouBSPporparceiro.BSPs parceiros.
1. Criação do Template
Logo oO primeiro passo é criar oum template:IMAGEMtemplate TELAde DEmensagem CRIAÇÃOdentro DEda TEMPLATEplataforma.
Com
Após a criação, o template criado,será enviado para aprovação da Meta.
2. Criação da Campanha
Após a criação do template, é necessário criar auma campanha:IMAGEMcampanha TELAde DE CRIAÇÕA DE CAMPANHAenvio.
Se
Caso utilizadaso template utilize variáveis, no template, éserá necessário atribuirinformar osa valorescorrelaçã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.
Uma vez com a campanha e posteriormente os valores devem ser passados no payload da URI apropriada.
3. Envio das Mensagens
Depois que o template devidamentee a campanha estiverem configurados, temosexistem aduas opçformas de adicionar contatos para envio:
-
Importação de
importar alista de contatosparapela interface -
Envio automático através da API
Neste documento vamos tratar somente os envios,dois oumétodos enviardisponí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 automaçrequisição comHTTP a nossa API. Temos dois métodos atualmente disponívels para fazer isso:GET.
1 - Opção
Exemplo de templatesURI
https://api.tallk.me/dbdial_webapi.php?acao=insere_whats_simples&id_cliente=123&id_wpp=123&token=LLU8EYBEUOMTWT2NRMKPXJS83HAUQORDIGHA82&num_dest=3199299012911988887777&txtmsg=teste&id_campanha=12345
Desta
Parâmetros sãda URL
| Parâmetro | Descrição |
|---|---|
| acao | Identifica internamente a insere_whats_simples) |
| id_cliente | Identificador do cliente ( |
| id_wpp | Identificador do canal de |
| token | Token de autorização do cliente para acesso à API |
| num_dest | Número de telefone que receberá a mensagem |
| txtmsg | Texto da mensagem. Em caso de API |
| id_campanha | Identificador da campanha previamente criada |
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 obtidoutilizada uma requisição HTTP POST.
Endpoint
| Parâmetro | Descrição |
|---|---|
| acao | Identifica internamente a ação a ser executada (envio_simples_whats_v2) |
| id_cliente | Identificador do cliente (disponível no canto superior direito da |
| id_wpp | Identificador do canal de WhatsApp (disponível na tela de números de envio) |
Exemplo de Payload da Requisição
{
"txtmsg":"Texto da mensagemmensagem",
a"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
| Campo | Descrição |
|---|---|
| txtmsg | Texto da mensagem. Ignorado quando utilizado com API oficial, pois o conteúdo enviado será o template |
| id_wpp | Identificador do canal de WhatsApp |
| email_dest | Email do destinatário (opcional, pode ser |
| numero_dest | Número |
| id_campanha | Identificador da campanha previamente criada |
| assunto | Assunto do email (opcional, usado em campanhas de email) |
Variáveis do Contato (info_contato)
As variáveis utilizadas nos templates são enviadas dentro do objeto info_contato.
| Campo | Descrição |
|---|---|
| documento | Identificador do cliente (CPF, CNPJ ou outro identificador único). Caso ausente, pode ser utilizado o |
| nome | Nome completo do cliente |
| telefone1 | Número principal do cliente (geralmente igual ao campo numero_dest) |
| telefone2 | Número secundário |
| telefone3 | Terceiro número opcional |
| Email do contato | |
| endereco | Endereço |
| bairro | Bairro |
| cep | CEP |
| cidade | Cidade |
| estado | UF |
| pais | País (ex: BR) |
| geral1 – geral5 | Campos genéricos que podem ser utilizados como variáveis adicionais |
⚠️ Observação:
Caso a campanhavariável PRIMEIRO_NOME seja utilizada no template, o sistema automaticamente extrai o primeiro nome a serpartir utilizadado (criadacampo no passo anterior)nome.