API, MCP e webhooks

Disponível para o gestor de uma conta no plano Business. A chave e os webhooks enxergam só as unidades da própria conta.

Onde configurar

1. Abra Ferramentas → API e webhooks (/integracoes/api). A documentação fica em /integracoes/api/docs
2. Crie uma chave. Anote na hora: ela não aparece de novo
3. Chame GET https://sagacrm.com.br/api/v1/me com o cabeçalho Authorization: Bearer <chave>

Limites

Cada chave tem teto por minuto: leitura, escrita, lote e MCP. A conta inteira tem um teto por dia. Acima disso a resposta é 429. Várias chaves inválidas do mesmo IP bloqueiam o IP por 15 minutos.

MCP

O endereço publicado é POST https://sagacrm.com.br/mcp, com a mesma chave. A aba MCP mostra como colocar no Claude, no Gemini e na OpenAI. O assistente lê os dados da conta. Ele não apaga registros nem envia WhatsApp.

Webhooks

Em /integracoes/webhooks, cadastre a URL HTTPS do n8n. O Saga republica as conversas do número conectado no Agente de vendas (eventos UAZAPI messages e messages_update): mensagem.recebida, mensagem.enviada e mensagem.status. O campo numero_conectado é o WhatsApp da conexão. Também envia lead.criado, lead.etapa_alterada, cliente.criado, venda.criada e conversa.transferida_humano.

Confira X-Saga-Signature: t=<unix>,v1=<HMAC-SHA256 do segredo sobre "<t>.<corpo>">. Ignore uma entrega repetida pelo X-Saga-Delivery.

Endereço interno, localhost e redirecionamento são recusados. Há teto de envios por minuto da conta e por destino, para o Saga não ser usado como origem de ataque.

Dúvidas frequentes

Não vejo o menu: o plano da conta precisa ser Business, e quem configura é o gestor (titular).

A chave parou: plano fora do Business responde 402. Revogar uma chave desliga na hora.