Starter
Integração inicial e validação do seu produto.
Em definição
- API REST e webhooks
- SDKs TypeScript
- Escopo conforme projeto
- Conexão não oficial
Chattoo · Integração gerenciada
Conecte produtos e automações ao WhatsApp com API REST, webhooks, SDKs Node.js e Browser e MCP. A conexão atual é não oficial, com liberação por instância. Seu sistema define as regras; o Chattoo faz a conexão.
Integre seu backend com chaves de projeto, escopos e comandos assíncronos.
Receba eventos assinados de mensagens e conexão no seu sistema.
Node.js, TypeScript, React e Next.js, além de ferramentas MCP para agentes autorizados.
Proposta de valor
Sua aplicação mantém as regras de negócio, a autenticação e a experiência do cliente. O Chattoo oferece a conexão com o WhatsApp, os comandos da API e os eventos para integrar essa operação.
Seu sistema
POST /v1-messages
Não oficial
Texto individual
Webhooks
Eventos assinados
O envio é assíncrono: o aceite de um comando não significa entrega ou leitura. Acompanhe o resultado e os eventos conforme o canal conectado.
API REST para instâncias, comandos e mensagens, com escopos e webhooks para acompanhar a operação.
Conexão via Baileys, liberada por instância. Sujeita a interrupções e risco de bloqueio pelo WhatsApp.
SDK Node.js no backend e SDK Browser para React, Vite e Next.js, com token protegido por um gateway autenticado.
Ferramentas e recursos MCP com token de projeto e permissões por operação. Compatibilidade depende do cliente utilizado.
Como funciona
Um fluxo para projetos com acesso liberado: credenciais, conexão, envio e acompanhamento por eventos.
Obtenha acesso ao projeto e uma chave com as permissões necessárias à integração.
Vincule o WhatsApp em uma instância não oficial liberada para a sua operação.
Dispare mensagens autenticadas via REST a partir do seu backend ou automação.
Configure endpoints para eventos de mensagem, ack e saúde da conexão.
Recursos
Capacidades para enviar, observar e evoluir o canal sem reescrever a integração.
Envie comandos por API e consulte o resultado. O aceite não equivale à entrega da mensagem.
Consulte o estado da instância e acompanhe os eventos da conexão autorizada.
Envie texto para destinatários individuais em instâncias liberadas. Mídia e grupos não estão disponíveis nesta versão.
Receba eventos de mensagem e status disponibilizados pelo canal, com assinatura HMAC.
Organize conexões por organização e projeto, com permissões e credenciais próprias.
Chaves com escopos, trilhas de operação e retentativas de webhooks. Preserve a mesma chave de idempotência ao repetir uma intenção.
Desenvolvedores
Use TypeScript no seu backend ou frontend, ou integre diretamente pela API REST. Os SDKs cuidam do contrato; você mantém o controle das permissões e dos eventos.
Token, instâncias, envio e acompanhamento de comandos.
Abrir documentaçãoExplore as rotas e teste a API com o token do seu projeto.
Testar no SwaggerReact, Vite e Next.js com gateway autenticado no seu backend.
Ler guia do frontendnpm install @chattoo-br/nodeTypeScript · backend · configure somente o token
import { Chattoo } from '@chattoo-br/node';
const chattoo = new Chattoo(process.env.CHATTOO_TOKEN!);
const { data: command } = await chattoo.messages.sendText(
{ to: '+5511999999999', text: 'Olá! Seu pedido está pronto.' },
{ idempotencyKey: 'pedido-123-confirmacao' },
);
// queued significa aceite. Entrega e leitura vêm pelos eventos.
console.log(command.id, command.status);npm install @chattoo-br/browserReact · Vite · Next.js · token protegido no backend
'use client'; // Para Client Components no Next.js.
import { ChattooBrowser } from '@chattoo-br/browser';
const chattoo = new ChattooBrowser(); // Gateway: /api/chattoo
export function SendButton() {
return <button onClick={() => chattoo.messages.sendText(
{ to: '+5511999999999', text: 'Olá! Seu pedido está pronto.' },
{ idempotencyKey: 'pedido-123-confirmacao' },
)}>Enviar</button>;
}
// Configure o gateway Node no seu servidor.
// O token nunca entra em VITE_* ou NEXT_PUBLIC_*.POST /backend/functions/v1/v1-messages
curl -X POST https://apis.chattoo.com.br/backend/functions/v1/v1-messages \
-H "Authorization: Bearer $CHATTOO_TOKEN" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: pedido-123-confirmacao" \
-d '{
"instanceId": "11111111-1111-4111-8111-111111111111",
"to": "+5511999999999",
"text": "Olá! Seu pedido está pronto."
}'Node.js · verificação HMAC sobre os bytes originais
import { createServer } from 'node:http';
import { createWebhookHandler } from '@chattoo-br/node';
createServer(createWebhookHandler({
secret: process.env.CHATTOO_WEBHOOK_SECRET!,
async onEvent(event) {
if (event.type === 'message.received') {
// Processe o evento no backend da sua aplicação.
// Conteúdo exige autorização explícita no webhook.
}
console.log(event.type);
},
})).listen(3000);
// Cadastre uma URL HTTPS pública e guarde o segredo HMAC.
// O segredo do webhook é diferente do token do projeto.Exemplos ilustrativos com destinatário fictício. O envio exige uma instância Baileys liberada e conectada. O token fica no backend; o navegador usa o gateway da sua aplicação. Meta e coexistência ainda não estão disponíveis em produção.
Casos de uso
Use o Chattoo como camada de transporte — o sistema de origem continua sendo a fonte da verdade.
Roteie conversas e respostas a partir do seu helpdesk.
Sincronize contatos e interações com o funil comercial.
Dispare lembretes e confirmações de pagamento.
Notifique status de pedido, estoque e logística.
Confirme consultas e envie lembretes automáticos.
Transacionais e alertas operacionais do produto.
Orquestre fluxos com seus workers e orquestradores.
Segurança e confiabilidade
Práticas de segurança e resiliência no desenho da plataforma. SLA formal será comunicado quando os planos estiverem disponíveis.
Dados e credenciais separados por tenant, reduzindo risco de cruzamento.
Crie, rotacione e revogue chaves sem interromper outras integrações.
Valide a autenticidade dos webhooks no seu endpoint com assinatura compartilhada.
Evite duplicidade em reenvios com chaves de idempotência nas operações críticas.
Processamento assíncrono com políticas de retry para eventos e entregas.
Trilhas para investigar envios, falhas e mudanças de configuração.
Preços
O acesso é disponibilizado de forma controlada. As modalidades abaixo estão em preparação: valores, limites e condições comerciais ainda não estão publicados.
Acesso ao serviço
Converse com o time sobre o seu fluxo, o canal disponível e a liberação das instâncias. A documentação é pública; o uso da API exige credenciais e permissões do projeto.
Integração inicial e validação do seu produto.
Em definição
Em preparação
Produtos com múltiplas conexões e eventos.
Em definição
Operações com maior necessidade de controle.
Em definição
Necessidades de integração a avaliar com o time.
Em definição
As modalidades não constituem uma oferta de contratação automática. Canal oficial, coexistência e cobrança automática não estão disponíveis nesta versão.
FAQ
Escopo disponível, integração segura e condições de acesso ao serviço.
Explore a API REST, os SDKs e o guia MCP. A integração começa pelo seu projeto, com escopos definidos e uma instância autorizada.