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/webhookAutorizaçã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/whatsappmessageAutorizaçã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/getHSMAutorizaçã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())


‍