Integraciones Privadas: Conecta tu cuenta con cualquier aplicación de terceros

Integraciones Privadas: Conecta tu cuenta con cualquier aplicación de terceros

Automatiza SMS, llamadas y eventos usando nuestra API. Con nuestras herramientas de integración, puedes conectar tu cuenta de manera segura con aplicaciones de terceros, CRMs o sistemas personalizados para enviar mensajes, activar llamadas y gestionar eventos automáticamente. Con Credenciales de Integración, puedes conectar tu cuenta de manera segura con aplicaciones de terceros, CRMs o sistemas personalizados para automatizar SMS, llamadas y eventos.

Credenciales de Integración

Las Credenciales de Integración son tus tokens de acceso que permiten a aplicaciones externas interactuar de manera segura con tu cuenta. Puedes usarlas para:

  • Enviar SMS

  • Activar llamadas

  • Recibir eventos mediante webhooks


Beneficios Clave

  • Simplicidad: Genera credenciales desde la configuración de tu cuenta y adminístralas fácilmente.

  • Seguridad: Restringe los permisos (scopes) que las aplicaciones de terceros pueden acceder.

  • Control: Rota o revoca credenciales en cualquier momento.


Cómo Usar las Credenciales de Integración

Usa tus credenciales en el header Authorization de las solicitudes API, igual que cualquier token de acceso.

Ejemplo: obtener webhooks de SMS:

 
curl --request GET \ --url https://api.zonitel.com/api/v3/integrations/sms/webhooks \ --header 'Accept: application/json' \ --header 'Authorization: Bearer <TU CREDENCIAL DE INTEGRACIÓN>' \ --header 'X-Client-Id: <TU CLIENT ID>'

Quién Puede Crear Credenciales de Integración

Por defecto, todos los administradores de la cuenta pueden crear y administrar credenciales.


Dónde Encontrar las Credenciales de Integración

  1. Ve a Administración → Integraciones.

  2. Selecciona Config en Automatización e Integraciones.

  3. En el menú lateral, encontrarás la Sección de Credenciales.


Cómo Crear una Nueva Credencial de Integración

Paso 1: Haz clic en Crear Nueva Credencial.
Paso 2: Proporciona una descripción para identificar su propósito.
Paso 3: Copia la credencial generada y compártela únicamente con desarrolladores de confianza.

Nota: No compartas las credenciales públicamente. Copia el token inmediatamente; no podrá recuperarse más tarde.


Buenas Prácticas

  • Rota tus credenciales cada 90 días por seguridad.

  • Comparte únicamente con desarrolladores o sistemas de confianza.

  • Revoca inmediatamente credenciales comprometidas.


Cómo Rotar una Credencial

  1. Ve a la Sección de Credenciales.

  2. Selecciona la credencial que deseas rotar.

  3. Haz clic en Rotar Credencial → Continuar para confirmar.

  4. Copia la nueva credencial y actualiza tus aplicaciones externas.

Nota: Una vez rotada, la credencial antigua deja de funcionar y no puede recuperarse.


Mi Credencial Ha Sido Comprometida

  1. Ve a la Sección de Credenciales.

  2. Selecciona la credencial afectada.

  3. Haz clic en Rotar Credencial Ahora → Continuar para confirmar.

  4. Actualiza inmediatamente tus aplicaciones externas con la nueva credencial.

Nota: Copia la nueva credencial inmediatamente; no podrá recuperarse después.


Cómo Eliminar una Credencial

Si la aplicación externa ya no se utiliza:

  1. Ve a la Sección de Credenciales.

  2. Selecciona la credencial y haz clic en Eliminar.


Webhooks

Recibe actualizaciones en tiempo real de SMS y llamadas mediante webhooks:

  • Webhooks de SMS: Notificaciones cuando un SMS es enviado, entregado o falla.

  • Webhooks de Llamadas: Actualizaciones sobre el estado de las llamadas, grabaciones y eventos.

¿Te ha sido útil este artículo?

¿Aún tienes preguntas?

Nuestro equipo de soporte está disponible 24/7 para ayudarte a comenzar

Habla con nosotros en WhatsApp