Pular para o conteúdo principal

Integrar usando uma IA

3 min de leituraAtualizado em 29 out. 2026

Não precisa saber programar para integrar o seu sistema à Atalia. Assistentes como Claude, ChatGPT e Cursor escrevem o código se tiverem a referência da API. Ela está num arquivo de texto feito para eles lerem:

O arquivo traz autenticação, todas as rotas, os campos, os erros, os eventos do webhook e como verificar a assinatura. Ele é público: a IA consegue abrir pelo link, sem login.

Passo a passo​

  1. Conecte uma caixa de entrada e gere a chave. Siga os três passos de Integração via API. A IA vai precisar do ID da caixa de entrada (ch_...).
  2. Copie o texto pronto. Em Começar, no card Não sabe programar?, clique em Copiar texto para a IA. O texto já vem com o link do llms.txt e o ID da sua primeira caixa de entrada.
  3. Cole na IA e diga qual é o seu sistema. Troque o fim do texto pelo que você usa: um site em WordPress, uma planilha, n8n, um sistema próprio em Node, PHP ou Python.
  4. Teste. Rode o código que a IA escreveu e, em Chave e webhook, clique em Enviar mensagem de teste para conferir se o seu sistema recebe os eventos.

O texto para a IA​

Se preferir escrever do zero, use este modelo:

Quero conectar meu sistema à Atalia para enviar e receber mensagens de WhatsApp.

Leia a documentação: https://chat.atalia.com.br/docs/llms.txt
Minha chave de API está na variável ATALIA_API_KEY.
Meu canal de WhatsApp tem o ID ch_xxxxxxxxxx.

Me explique passo a passo, como para alguém que não programa, e escreva o código para o meu sistema: [diga qual é, ex.: site em WordPress, planilha, n8n].
Nunca cole a chave na conversa

A chave da API dá acesso ao envio de mensagens pelas suas caixas de entrada. Diga à IA que ela está numa variável de ambiente (ATALIA_API_KEY) e coloque o valor direto no servidor. Se a chave vazar, gere uma nova em Chave e webhook: a anterior para de funcionar na hora.

Quer um ponto de partida maior? O projeto de exemplo traz o texto de um sistema completo (webhook, agente de IA e painel de conversas) e o código pronto desse sistema.

Peça para a IA cuidar disto​

Estes pontos evitam os problemas mais comuns. Vale colar junto com o texto:

  • Responder o webhook com 200 logo que receber e processar depois. A Atalia espera no máximo 10 segundos.
  • Conferir o header X-Atalia-Signature em todo evento antes de confiar nele.
  • Ignorar eventos repetidos pelo id (evt_...): o mesmo evento pode chegar mais de uma vez.
  • Mandar o header Idempotency-Key em todo envio, para uma nova tentativa não duplicar a mensagem.
  • Responder o cliente pelo conversation_id que chegou no evento message.received.
  • No WhatsApp, usar template aprovado para começar conversa ou falar depois de 24 horas sem mensagem do cliente.

Arquivos em texto​

ArquivoO que tem
llms.txtReferência completa da API de integração: autenticação, rotas, erros, eventos e assinatura do webhook.
Última atualização em