Crie integrações com o WhatsApp rapidamente usando a API do ChatArchitect.

Conecte facilmente seus sistemas ao WhatsApp usando nossa API REST — envie e receba mensagens, acompanhe o status de entrega e gerencie modelos.

COMECE JÁ! Referência da API

1. Introdução

O ChatArchitect oferece uma API simples e confiável para integrar o WhatsApp aos seus sistemas, aplicativos ou CRMs. Você pode enviar mensagens de texto, mídia e interativas, acompanhar status, gerenciar modelos e armazenar dados personalizados — tudo com simples requisições HTTPS.

2. Início rápido

  1. Autentique-se com suas credenciais: Use seu APP_ID e APP_SECRET por meio da Autenticação Básica.
  2. Registre seu webhook
Exemplo >>>
POST https://api.chatarchitect.com/webhook Autorização
 : Básica Content-Type: application/json
 {   "channel" : "whatsapp" ,   "destination" : "96996999699" ,   "webhook" : "https://your-server.com/webhook" ,   "webhook_separate" : "false"
 }

 

  1. Envie sua primeira mensagem
Exemplo >>>
POST https://api.chatarchitect.com/whatsappmessage Autorização
 : Básica Content-Type: application/json
 {   "channel" : "whatsapp" ,   "destination" : "96996999699" ,   "payload" : {     "type" : "text" ,     "message" : "Olá John, como você está?"
 } }

 

  1. Receba atualizações de entrega via Webhook
Exemplo >>>
{   "type" : "message-event" ,   "payload" : {     "id" : "ee4a68a0-1203-4c85-8dc3-49d0b3226a35" ,     "type" : "delivered"
 } }

3. Tipos de mensagens suportados

Tipo Descrição Campo de exemplo
texto Mensagem de texto simples mensagem
imagem Enviar imagens (JPG/PNG) URL original
áudio Enviar áudio (MP3/OGG/AAC) URL
vídeo Enviar vídeos (MP4) URL, legenda
arquivo Enviar documentos nome do arquivo, legenda
localização Enviar coordenadas GPS latitude, longitude
contato Enviar informações de contato contato
lista / resposta_rápida Mensagens interativas opções

4. Modelos de mensagens (HSM)

São necessários modelos para mensagens iniciadas pela empresa. Recupere ou crie modelos facilmente através da API.

  1. Recuperar modelos disponíveis
Exemplo >>>
POST https://api.chatarchitect.com/getHSM Autorização
 : Básica {   "canal" : "whatsapp" ,   "destino" : "96996999699" ,   "obterHSM" : "verdadeiro"
 }

 

  1. Enviar um novo modelo
Exemplo >>>
POST https://api.chatarchitect.com/submit_template {
 "   channel" : "whatsapp" ,   "destination" : "96996999699" ,   "submit_template" : {     "elementName" : "welcome_offer" ,     "languageCode" : "en_US" ,     "category" : "MARKETING" ,     "templateType" : "TEXT" ,     "content" : "Bem-vindo(a) {{1}}! Seu código de desconto é {{2}}." ,     "example" : "Bem-vindo(a) [John]! Seu código de desconto é [12345]."
 } }

5. Webhooks e Eventos

Tipo de evento Descrição
mensagem Novas mensagens recebidas
evento de mensagem Status da entrega (enviado, entregue, lido, falhou)
evento do usuário Opção de adesão/desativação por parte do usuário

6. Exemplos de trechos de código

Node.js

import fetch from  "node-fetch" ; const auth = Buffer.from( ` ${APP_ID} : ${APP_SECRET} ` ).toString( "base64" );
 await fetch( "https://api.chatarchitect.com/whatsappmessage" , {   method : "POST" ,   headers : { "Authorization" : `Basic ${auth} ` , "Content-Type" : "application/json" },   body : JSON .stringify({     channel : "whatsapp" ,     destination : "96996999699" ,     payload : { type : "text" , message : "Olá John!" } } ) });


‍

Python

import requests, base64 auth = base64.b64encode(f "{APP_ID}:{APP_SECRET}" .encode()).decode() r = requests.post(   "https://api.chatarchitect.com/whatsappmessage" , headers={ "Authorization" : f "Basic {auth}" , "Content-Type" : "application/json" }, json={ "channel" : "whatsapp" , "destination" : "96996999699" , "payload" : { "type" : "text" , "message" : "Oi John!" }} ) print(r.json())


‍