Referencia de la API
La API de Eclectic te permite gestionar mensajes, plantillas, contactos, conversaciones, agentes y datos de búsqueda, además de recibir eventos webhook en tiempo real. Las solicitudes se realizan sobre HTTPS y se autentican con una API key.
Contacta al equipo antes de usar la API
Antes de empezar a usar la API debes contactar al equipo de Eclectic para habilitar tu acceso y obtener tu token. Escríbenos para coordinar la integración.
URL base
Todas las solicitudes a la API se realizan sobre la siguiente URL base. Cada endpoint de esta referencia es relativo a ella.
https://eclectic-api-537143970188.us-central1.run.app/api/external/v2¿Migras desde Callbell?
Los endpoints de mensajería y contactos son compatibles con la API de Callbell: apunta tu integración a esta URL base en lugar de https://api.callbell.eu/v1 y mantén las mismas rutas. En esos endpoints tu API key también se acepta como cabecera Authorization: Bearer.
Formato y cabeceras
La API acepta y devuelve JSON. Envía siempre la cabecera Content-Type: application/json en las solicitudes con cuerpo.
Límites de uso
Las solicitudes tienen un límite de uso por token de API. Si superas el límite recibirás una respuesta 429 y deberás reintentar tras una breve espera.
Errores
Los errores se devuelven con el código de estado HTTP correspondiente y un cuerpo JSON que describe el problema.
{
"errors": [
{
"code": "unauthorized",
"message": "Invalid or missing API token"
}
]
}