Ligar a Íris a outros sistemas

Crie a chave da API e os webhooks para o seu CRM, ERP, n8n ou formulário falarem com a Íris.

Passo a passo

Peça ao administrador da sua empresa para abrir Configurações › Chaves da API. Dê um nome à chave (como n8n), marque Leitura e, se o outro sistema vai criar leads, Escrita. Clique em Criar chave.
Copie a chave na hora e guarde como uma senha: ela não aparece de novo. No outro sistema, mande no cabeçalho Authorization: Bearer, seguido da chave.
Abra a Documentação da API: o link fica no mesmo cartão e leva à página /api/v1/docs. Ali estão as rotas dos leads, das etapas do CRM e do Radar, com os exemplos.
Para a Íris avisar o outro sistema, abra Configurações › Webhooks. Cole a URL (com https), marque os eventos (como Lead novo e Mudou de etapa no CRM) e clique em Criar webhook. Guarde o segredo: com ele, o outro sistema confere a assinatura de cada aviso.
Clique em Testar. Em até um minuto, o outro sistema recebe o evento teste. Em Ver as entregas, você acompanha cada aviso e a resposta do sistema.

O outro sistema recebe Chave inválida.: Confira se a chave foi copiada inteira e vai como Authorization: Bearer. Se ela foi revogada, crie outra em Configurações › Chaves da API.
O outro sistema recebe Escopo insuficiente.: A chave não tem o escopo pedido (por exemplo, Escrita para criar lead). Crie uma chave com ele e revogue a antiga.
A entrega do webhook aparece como Falhou.: Veja a resposta em Ver as entregas. O sistema precisa responder com sucesso (2xx) em até 10 segundos. Corrija e use Testar de novo.