Ciclo de vida de um pedido
0%
Webhook recebido
O WhatsApp entrega a mensagem ao seu endpoint, assinada e em tempo real.
50%
O agente raciocina
A IA extrai entidades em JSON e chama ferramentas (function calling) para consultar o catálogo.
100%
Decisão de roteamento
Resolve sozinho via API externa ou abre um ticket e avisa o atendente por WebSocket.
POST /webhook/whatsapp
X-Wacrm-Signature: sha256=9f2c…e1
{
"event": "message.received",
"instance_id": "inst_8f2c1a",
"from": "+244923000000",
"text": "Quero 2 unidades do Pro e pagar por transferência.",
"timestamp": "2026-09-28T14:32:10Z"
}agent.run → entities
{
"intent": "purchase",
"product": "Pro Business",
"quantity": 2,
"payment": "bank_transfer"
}
tool_call get_product({ "name": "Pro Business" })
tool_result { "price": 79.0, "currency": "USD", "stock": "ok" }{
"decision": "escalate",
"reason": "quantity > 1 requires approval",
"pending_action": "sales.register_sale",
"ticket": { "id": "tk_2210", "assignee": "marta" }
}
ws → conversation.assigned
{ "to": "marta", "context": "resumo + etiquetas + valor" }Nenhuma instância ativa. Crie uma sessão gratuita de 30 min.
Gere a instância
Clique em "Iniciar sandbox" para criar uma sessão temporária com token Bearer próprio.
Escaneie o QR Code
Abra o WhatsApp no telemóvel → Aparelhos conectados → Conectar um aparelho.
Dispare requisições
Use o Playground abaixo ou o token acima em qualquer cliente HTTP.
Dispara uma mensagem de texto simples ou com mídia (imagem/documento) para um número de WhatsApp.
Headers
Body
Lista conversas ativas, contactos e status das últimas mensagens.
Registra uma URL para receber eventos assinados via HMAC (header X-Signature).
curl -X POST "https://api.converso.io/api/v1/messages" \
-H "Authorization: Bearer crm_live_9f83a8b2c4e107d3f84" \
-H "Content-Type: application/json" \
-d '{
"to": "+244923000000",
"text": "Olá! Testando a API do WhatsApp via Gateway 🚀"
}'Instâncias permanentes, múltiplos números e proxy residencial anti-ban.