API pública (OpenAPI)
Consulte a Documentación API, autentique com API key e use o plano com useExternalApi.
Onde está
Vá em Administración → Configuración de la empresa (/company-settings) e abra a aba Documentación API.
A aba está disponível conforme o tenant (esquema administrador / OpenAPI habilitado). O uso de API externa também depende do plano (useExternalApi).
Autenticação
- Obtenha a API key da empresa (seção de integrações externas na aba Empresa, ou o botão de copiar na documentação quando estiver visível).
- Envie em cada request:
Authorization: Bearer <api_key>Não use x-external-secret nem validação de domínio de widget: essa autenticação é distinta da do chat web.
O que permite
A documentação na tela descreve como consultar e atualizar leads e contatos a partir de sistemas externos (caminho inverso aos webhooks).
Importante: as atualizações feitas por esta API não disparam webhooks de volta; a resposta HTTP é a confirmação.
Relação com webhooks
| Webhooks | Documentación API | |
|---|---|---|
| Aba | Webhooks | Documentación API |
| Direção | whapi → seu sistema | seu sistema → whapi |
| Auth | Secret de assinatura nas entregas | Bearer API key |
Configure ambos em Configuración de la empresa conforme queira receber notificações, enviar mudanças, ou as duas coisas.