API pública (OpenAPI)
Consulta la Documentación API, autentica con API key y usa el plan con useExternalApi.
Dónde está
Ve a Administración → Configuración de la empresa (/company-settings) y abre la pestaña Documentación API.
La pestaña está disponible según el tenant (esquema administrador / OpenAPI habilitado). El uso de API externa también depende del plan (useExternalApi).
Autenticación
- Obtén la API key de la empresa (sección de integraciones externas en la pestaña Empresa, o el botón de copiar en la documentación cuando esté visible).
- Envía en cada request:
Authorization: Bearer <api_key>No uses x-external-secret ni validación de dominio de widget: esa autenticación es distinta a la del chat web.
Qué permite
La documentación en pantalla describe cómo consultar y actualizar leads y contactos desde sistemas externos (camino inverso a los webhooks).
Importante: las actualizaciones hechas por esta API no disparan webhooks de vuelta; la respuesta HTTP es la confirmación.
Relación con webhooks
| Webhooks | Documentación API | |
|---|---|---|
| Pestaña | Webhooks | Documentación API |
| Dirección | whapi → tu sistema | tu sistema → whapi |
| Auth | Secret de firma en entregas | Bearer API key |
Configura ambos en Configuración de la empresa según si quieres recibir notificaciones, empujar cambios, o las dos cosas.