Integraciones Privadas: Conecta tu cuenta con cualquier aplicación de terceros
Integraciones Privadas es donde conectas Zonitel con un CRM, un sistema de reservas o tu propio panel. Encuentra la pantalla y sus tres pestañas, crea y rota credenciales de acceso, entiende qué se puede automatizar en llamadas y mensajería, y sigue los enlaces a las dos guías para desarrolladores.
Integraciones Privadas es donde conectas Zonitel con el software que ya usas: un CRM, un sistema de reservas, un panel interno. Aquí creas una credencial de acceso y tu desarrollador la usa para leer tus llamadas y mensajes o para actuar sobre ellos.
Dónde encontrarlo
Entra en tu Portal de Oficina de Zonitel. En la barra lateral izquierda, abre Configuración y haz clic en Integraciones Privadas. La pantalla tiene tres pestañas:
- Resumen — qué puedes hacer desde aquí, con enlaces a la documentación de la API y a una colección de Postman.
- Credenciales — crea, copia y revoca los tokens de acceso que usan tus sistemas, y consulta tu identificador de cliente.
- Webhooks — las direcciones a las que enviamos los eventos de llamadas y mensajes.
El título de la página es Automation & Integrations Dashboard. También puedes llegar desde Settings → Integrations → Automation & Integrations → Manage.
Qué puedes automatizar
Llamadas: leer tu historial, descargar grabaciones y transcripciones, recibir un aviso cuando entra una llamada y lanzar una llamada desde tu propia aplicación, que es la base de un botón de clic para llamar en un CRM.
Mensajería: enviar SMS y MMS, recibir los mensajes entrantes, consultar un mensaje enviado y programar campañas masivas.
Ver las llamadas en curso en pantalla es otra cosa, y vive en el portal y no en la API — consulta Active Panel-Calls.
WhatsApp: consulta si la cuenta puede enviar, lista los números y plantillas aprobadas y envía mensajes por la API. Empieza con Enviar mensajes de WhatsApp con la API.
Crea una credencial
- Abre la pestaña Credenciales.
- Haz clic en Nueva credencial y ponle una descripción que diga para qué sistema es.
- Copia el token mientras está en pantalla. Se muestra una sola vez.
- Anota tu identificador de cliente de esa misma pestaña. Las peticiones necesitan los dos valores.
Crea una credencial por sistema. Así, cuando haya que revocar una, desactivas una sola integración y no todas las que tengas.
Usa una credencial
Los dos valores viajan como encabezados en cada petición.
curl --request GET \
--url https://api.zonitel.com/api/v3/integrations/sms/webhooks \
--header 'Authorization: Bearer TU_TOKEN' \
--header 'X-Client-Id: TU_CLIENT_ID' \
--header 'Accept: application/json'
Rota, reemplaza o elimina una credencial
Para rotar una, abre la pestaña Credenciales, selecciónala, haz clic en Rotate Credential y confirma con Continue. Copia el valor nuevo de inmediato y actualiza tus sistemas. El token anterior deja de funcionar en ese momento, y ni el viejo ni el nuevo se pueden recuperar después.
Si crees que un token quedó expuesto, rótalo de inmediato en lugar de esperar a una ventana de mantenimiento: un token expuesto puede actuar sobre tu cuenta hasta que lo reemplaces.
Para quitar una integración que ya no usas, selecciona su credencial en esa misma pestaña y haz clic en Eliminar.
Los administradores de la cuenta pueden crear y gestionar credenciales.
Webhooks
La pestaña Webhooks tiene dos direcciones, una para llamadas y otra para mensajes. Cada una debe estar activa y responder con HTTP 200 para poder guardarse, y borrar el campo la elimina. Incoming Call Webhooks explica el evento de llamada en detalle.
Para los métodos HTTP y la autenticación del receptor, consulta Advanced en Incoming Call Webhooks y SMS Webhooks.
Hacia dónde seguir
Dos guías retoman donde esta termina, ambas con endpoints y ejemplos que funcionan: Sincroniza tus llamadas con la API y Envía y recibe SMS con la API.
¿Necesitas ayuda?
Llamada/Texto/WhatsApp: (833) 966-4835
Email: info@zonitel.com