Integrar com IA

Você não precisa ser programador para integrar com a TopTalking. As ferramentas de IA (Lovable, Claude, Cursor, ChatGPT…) escrevem o código por você — desde que recebam a documentação certa e as regras certas. Esta seção entrega as duas coisas, com prompts prontos para copiar e colar.

Como as IAs leem esta documentação

Recurso	Endereço	Para quê
llms-full.txt	https://platform.toptalking.com.br/llms-full.txt	A documentação inteira em texto puro. É o que você entrega para a IA escrever código.
llms.txt	https://platform.toptalking.com.br/llms.txt	Índice curto com as regras essenciais e links para as outras versões.
llms-small.txt	https://platform.toptalking.com.br/llms-small.txt	Versão compacta, para IAs com pouco contexto.
openapi.yaml	https://platform.toptalking.com.br/openapi.yaml	O contrato da API (OpenAPI 3.1). Ideal para ChatGPT Actions, Postman e geradores de código.
Servidor MCP	https://platform.toptalking.com.br/mcp	Para a IA usar a sua conta (consultar, enviar), em vez de escrever código.

Mais detalhes em llms.txt e OpenAPI.

Escolha o seu caminho

Você usa…	Quer…	Caminho
Lovable	Um app com WhatsApp	Guia do Lovable — Edge Functions + prompts prontos
Claude Code	Código ou operar a conta	Claude — MCP + CLAUDE.md
claude.ai	Tirar dúvidas, gerar código	Claude — Projeto com a documentação
Cursor, Windsurf, Copilot	Código no seu editor	Cursor, Windsurf e Copilot — @Docs, regras e MCP
ChatGPT	Um assistente que consulta a conta	ChatGPT — GPT personalizado com Actions
Bolt, v0, Replit	Um app full-stack	Bolt, v0 e Replit
n8n, Make, Zapier	Automação sem código	n8n, Make e Zapier

As regras de ouro

Estas regras valem para qualquer ferramenta. Os prompts desta seção já as incluem — se você escrever os seus, inclua também.

1. A chave fica só no servidor. Nunca no React, no HTML, no app mobile ou no chat com a IA. A API não aceita chamadas do navegador. Use Edge Function, rota de API, servidor ou n8n/Make/Zapier, com a chave em um secret (TOPTALKING_API_KEY).
2. Toda mensagem enviada leva Idempotency-Key. IAs e automações repetem chamadas; a chave de idempotência impede mensagens duplicadas no WhatsApp do cliente.
3. Só mande mensagem para quem pediu. Nada de disparos em massa com POST /messages: o WhatsApp pode banir o número. Para campanhas, use Campanhas (WhatsApp Oficial, com aprovação).
4. Webhooks: valide a assinatura (X-TopTalking-Signature) com o corpo cru antes de confiar no evento.
5. Para explorar, use uma chave “Somente leitura”. Libere escrita só quando o fluxo estiver testado.
6. Trate erros pelo code e respeite o Retry-After em 429.

Bloco de contexto (cole em qualquer IA)

Se a sua ferramenta não está nos guias, comece a conversa colando este bloco:

Contexto: vou integrar meu sistema com a API da TopTalking (WhatsApp + CRM com Kanban).

Documentação completa (leia antes de escrever código): https://platform.toptalking.com.br/llms-full.txt
Contrato OpenAPI 3.1: https://platform.toptalking.com.br/openapi.yaml

Regras obrigatórias:
- URL base: https://platform.toptalking.com.br/v1 — JSON em UTF-8.
- Autenticação: cabeçalho "Authorization: Bearer <chave>". A chave fica numa variável de ambiente/secret chamada TOPTALKING_API_KEY.
- NUNCA coloque a chave em código de front-end (navegador/app) nem no código-fonte. A API bloqueia chamadas do navegador (sem CORS): toda chamada deve sair do backend (servidor, Edge Function, rota de API, automação).
- Envios (POST /messages e POST /scheduled-messages) sempre com o cabeçalho Idempotency-Key, derivado do ID da operação (ex.: "pedido-1234-despachado").
- Erros vêm como { "error": { "type", "code", "message", "param", "request_id" } }. Trate pelo "code". Em 429, espere os segundos do cabeçalho Retry-After.
- Listas usam paginação por cursor: { "object": "list", "data": [...], "has_more", "next_cursor" }; envie ?cursor=<next_cursor>; limit de 1 a 100.
- Telefones com DDI e DDD, só dígitos (ex.: 5511999998888).
- Webhooks: valide X-TopTalking-Signature ("t=<unix>,v1=<hex>"; v1 = HMAC-SHA256 em hex de "<t>.<corpo cru>" com o secret whsec_... guardado em TOPTALKING_WEBHOOK_SECRET; tolerância de 300 s; comparação em tempo constante). Responda 2xx em até 10 s e deduplique pelo "id" do evento.
- Não invente endpoints nem campos: use só o que está na documentação.
- Nada de envio em massa: uma mensagem por ação do usuário/cliente.

Guias

LovableSecrets, Edge Functions e 4 prompts prontos.

ClaudeClaude Code, Projetos no claude.ai e Claude Desktop.

Cursor, Windsurf e Copilot@Docs, regras do projeto e MCP.

ChatGPTGPT personalizado com Actions e prompts para Codex.

Bolt, v0 e ReplitRotas de backend e prompts por plataforma.

n8n, Make e ZapierConfiguração do nó HTTP e do gatilho de webhook.