Como empresa, você pode querer enviar mensagens do WhatsApp para seus clientes automaticamente quando ocorrer algum evento pertencente ao cliente.
Uma maneira de conseguir isso é usando o Interakt Rastrear APIs para enviar esses eventos para Interakt & setting Campanhas em andamento no Interakt. Você deve escolher este método se:
. Você deseja manter seu esforço de codificação ao mínimo.
. Neste método, você simplesmente precisa fazer chamadas de API quando ocorrer um evento em seu sistema (site/aplicativo/CRM etc.)
. Você não precisa se preocupar em alterar as mensagens que deseja enviar quando esse evento ocorrer.
. Se você tiver lógicas complexas para quando quiser que a mensagem seja enviada, não será necessário construir essas lógicas. Por exemplo:
. Suponha que você queira que a mensagem seja enviada com algum atraso após um evento, ou,
. você deseja que a mensagem seja enviada após o evento apenas se o usuário tiver determinados atributos ou,
. Você deseja que a mensagem seja enviada após o evento somente se o usuário não realizar outro evento em algumas horas, etc.
. Você deseja ver facilmente os resultados (estatísticas de entrega/leitura) dessas campanhas sem ter que construir um painel próprio para isso.
. Um resumo de suas campanhas está facilmente disponível para você em Painel de campanha da Interakt.
. Seu site é construído usando Shopify. Temos integração direta com Shopify! Você não precisa chamar nenhuma API para enviar mensagens do WhatsApp quando seu cliente abandona o carrinho/faz um pedido, etc.
A segunda maneira de conseguir isso é usar as APIs de envio de modelos da Interakt (fornecidas abaixo) para enviar as mensagens (modelos/HSMs) diretamente para o WhatsApp e, em seguida, consumir os webhooks enviados pela Interakt que contêm informações sobre se as mensagens foram enviadas, entregues, lidas ou falhadas. Você deve escolher este método se:
. Você tem largura de banda e recursos de codificação para:
. construir um processo para permitir mudanças frequentes das mensagens que devem ser enviadas
. construir lógicas complexas para quando enviar a mensagem.
. Você já possui um painel onde acompanha suas campanhas (de outros canais) e por isso deseja acompanhar suas campanhas de WhatsApp nesse mesmo painel.
(ou você pode estar usando um Marketing WhatsApp ferramenta de automação para ambos os itens acima)
. Você também pode usar esta segunda forma se quiser acionar SMS/E-mails caso a mensagem do WhatsApp não chegue ao cliente.
Detalhes das APIs de envio de modelos:
Ligar /v1/público/mensagem/ para enviar o modelo conforme necessário
1. Se desejar armazenar quaisquer atributos de nível de mensagem, você poderá usar o dados_de_chamada parâmetro para enviar dados adicionais. Isso será retornado a você nos webhooks correspondentes.
2. Enviaremos um id em resposta à sua chamada de API. Esse id podem ser armazenados para referência futura. Este ID será referido quando os webhooks forem retornados posteriormente.
URL: https://api.interakt.ai/v1/public/message/
Forma: PUBLICAR
Cabeçalhos:
• Autenticação:
• Você pode autenticar enviando a chave API junto com os dados da solicitação.
• Mecanismo de autenticação usa Autenticação básica HTTP que exige que você envie a chave API com o 'Básico' string.
• O par de chaves do cabeçalho será semelhante a 'Autorização: BásicoChave API>'.
. A chave API estará disponível em seu painel do Interakt nas configurações do desenvolvedor: https://app.interakt.ai/settings/developer-setting
• Tipo de conteúdo:
• Você deve definir o cabeçalho do tipo de conteúdo como 'application/json' para poder enviar dados ao nosso endpoint da API HTTP.
. Plano de Crescimento – 300 solicitações por minuto
. Plano Avançado – 600 solicitações por minuto
. Plano Enterprise – Configurável conforme o limite de taxa permitido pela Meta
Corpo da solicitação:
1 exemplo:
. Se o cabeçalho do modelo for do tipo texto e também contiver uma variável
. O corpo contém variáveis
. O modelo tem 1 botão CTA que contém um URL dinâmico
{
“códigopaís”: “+xx”, /* obrigatório */
“Número de telefone”: “xxxxxxxxxx”, /* obrigatório */
“tipo”: “Modelo”, /* obrigatório */
“callbackData”: “some_callback_data”, /* string opcional com comprimento máximo 512 */
"modelo": {
“nome”: “delivered_alert_101”, /* obrigatório */
“idiomaCode”: “en”, /* obrigatório */
“Valores de cabeçalho”: [
“Alerta”, /* valor da variável {{1}} no texto do cabeçalho*/
],
“fileName”: “dummy.pdf”, /* opcional e aplicável apenas com cabeçalho do documento */
“valorescorporais”: [
“Lá”, /* valor da variável {{1}} no corpo do texto */
“1234” /* valor da variável {{2}} no corpo do texto */
],
“Valores de botão”: {
“0” /*índice do botão */ :[
“12344” /* valor para {{1}} para url dinâmico no botão no índice
posição 0*/
]
}
}
}
2 exemplo:
. Se o cabeçalho do template for do tipo media (imagem/vídeo/documento) – a lista headerValues terá apenas um elemento com o valor do mediaUrl
. O corpo contém variáveis
. O modelo tem 2 botões de CTA – o primeiro contém um número de telefone e o segundo contém um URL dinâmico.
{
“códigopaís”: “+xx”, /* obrigatório */
“Número de telefone”: “xxxxxxxxxx”, /* obrigatório */
“tipo”: “Modelo”, /* obrigatório */
“callbackData”: “some_callback_data”, /* string opcional com comprimento máximo 512 */
"modelo": {
“nome”: “delivered_alert_101”, /* obrigatório */
“idiomaCode”: “en”, /* obrigatório */
“Valores de cabeçalho”: [
“https://interaktstorage.blob.core.windows.net/mediastoragecontainer/91e5634a-33b0-44b4-a075-884778f02feb/message_template_sample/tcITOHfOz6vy.png?se=2026-08-13T11%3A53%3A58Z&sp=rt&sv=2019-12-12&sr=b&sig=PDn3cPLmV%2BYu3D7Wd10JYmPLQeyGyytl013wAtmbL6g%3D” /* media url for the header’s media file */
],
“valorescorporais”: [
“Lá”, /* valor da variável {{1}} no corpo do texto */
“1234” /* valor da variável {{2}} no corpo do texto */
],
“Valores de botão”: {
“1” /*índice do botão */ :[
“12344” /* valor para {{1}} para url dinâmico no botão na posição de índice 0*/
]
}
}
}
Corpo de Resposta:
{
“resultado”: verdadeiro,
“mensagem”: “Mensagem criada com sucesso”,
“id”: “6c2d7175-fddd-4fbf-b0eb-084f170dbe08”
}
O processo de id retornado é o ID da mensagem. Pode ser usado para se referir aos webhooks de mensagens.
Campo e Descrição
número de telefone: Número de telefone do usuário, certifique-se de que não contenha o código do país ou “0” (zero) no início do número
Código do país: Código do país do telefone do usuário
type: Tipo de mensagem a ser enviada
Valores Suportados: Modelo
Nome do modelo
Certifique-se de que o modelo foi criado no Interakt. O nome do modelo a ser usado é o nome de código do modelo. Como obter o codinome?
. Acesse https://app.interakt.ai/templates/list.
. Clique no modelo que deseja usar
. A página que será aberta terá o seguinte URL: https://app.interakt.ai/template/nome de código/visualizar
. Nome do código = a parte do URL entre 'template/' e '/view'
OR, se quiser usar um modelo que foi criado por você no Facebook Business Manager, clique em Sincronizar em https://app.interakt.ai/templates/list e depois que a sincronização for concluída, você verá o modelo aparecer na lista.
Código do idioma
O código do idioma deve corresponder ao idioma no qual você criou o modelo. você pode encontrar todos os códigos de idioma aqui: https://developers.facebook.com/docs/whatsapp/api/messages/message-templates/
headerValues /bodyValues /buttonValues
Valores das variáveis contidas no modelo
. Cabeçalho (se o tipo de cabeçalho for texto e houver uma variável nele OU se o tipo de cabeçalho for mídia)
. Corpo
. botão (apenas caso haja uma URL dinâmica no botão)
Exemplo 3: Como enviar carga útil nos botões de resposta rápida do modelo
(Isso é relevante apenas se você estiver usando uma conta Interakt para enviar campanhas do WhatsApp e também tiver um bot Haptik ativo. As cargas úteis do botão serão retornadas pelo WhatsApp em seus webhooks, sempre que um cliente clicar no respectivo botão.)
O exemplo abaixo mostra a carga útil a ser usada para um modelo com:
. Um cabeçalho de documento
. 1 variável no corpo
. 3 botões de resposta rápida (e cargas úteis para cada botão)
{
“códigopaís”: “+91”,
“Número de telefone”: “9999999999”,
“callbackData”: “algum texto aqui”,
“tipo”: “Modelo”,
"modelo": {
“nome”: “temp_with_quick_reply_buttons”,
“código de idioma”: “en”,
“Valores de cabeçalho”: [
“https://interaktstorage.blob.core.windows.net/mediastoragecontainer/07ed4524-9549-481b-ad51-400200cabe0b/message_template_media/UkJYYpHdmCBc.pdf?se=2027-01-14T09%3A53%3A35Z&sp=rt&sv=2019-12-12&sr=b&sig=iJvIT6trhzcb81xg92HytxN2SH8p4YPX8xg5IItCUgQ%3D”
],
“fileName”: “Documento de amostra para teste.pdf”,
“valorescorporais”: [
“algum texto aqui se houver alguma variável no corpo da mensagem”
],
“botãoPayload”: {
“0”: [“carga útil0”],
“1”: [“carga útil1”],
“2”: [“carga útil2”]
}
}
}
Parâmetro a ser usado
botãoPayload
Descrição
Tipo de dados suportado – Para a carga útil apenas o tipo de dados string é permitido. Qualquer caractere como @,%,* ou espaço junto com valores alfanuméricos são aceitos, mas apenas dentro do tipo de dados string, como
“12 345abc( ) ? ! . #% @ ^ = + – & * ` ~ ; : < > { }”
Limite de caracteres de carga útil – O limite de caracteres de carga útil é de 128 caracteres.
Observação: A numeração dos botões começa em 0. Pode haver no máximo 3 botões.
API de envio de modelo do WhatsApp da Interakt
Para rastrear sua campanha de API de envio de modelo de análise, você pode criar uma campanha de API e rastrear as análises no próprio painel do Interakt. Clique aqui. para saber mais sobre campanhas de API.
Para garantir que as análises da campanha API sejam registradas no Interakt Dashboard, use o “ID da campanha”Valor recebido na resposta ao chamar a API “Criar campanha de API”
Exemplo
Corpo da solicitação
curl –location 'https://api.interakt.ai/v1/public/message/' \
–header 'Autorização: Básica {{YOUR_API_KEY}}' \
–header 'Tipo de conteúdo: aplicativo/json' \
-dados '{
“códigopaís”: “+91”,
“Número de telefone”: “9999999999”,
"ID da campanha”: “SEU_CAMPAIGN_ID”,
“callbackData”: “algum texto aqui”,
“tipo”: “Modelo”,
"modelo": {
“nome”: “nome_modelo_aqui”,
“código de idioma”: “en”,
“valorescorporais”: [
“corpo_variável_valor_1”,
“corpo_variável_valor_n”
]
}
}'
Observação: Caso você não mencione o “ID da campanha” no campo Corpo, a campanha ainda receberia Enviados mas as análises não serão registradas no Interakt Dashboard.
