Skip to main content

​
Antes de empezar

Twilio es el servicio que permite que tu aplicación haga y reciba llamadas, además de enviar mensajes SMS. Tu app proporciona la interfaz; Twilio proporciona la infraestructura global de telecomunicaciones detrás. Para conectarlo, necesitarás dos credenciales de tu cuenta de Twilio: Account SID y Auth Token. Estas son las “llaves” que autorizan a tu aplicación a usar tu cuenta de Twilio. Requisitos:
  • Una cuenta de Twilio activa.
  • Acceso de administrador al CMS de tu aplicación.
  • Recomendado: habilitar autenticación de dos factores en Twilio y guardar tus credenciales en un gestor de contraseñas seguro.

​
Paso 1: Ve al CMS y abre Integrations

Abre el CMS desde este enlace directo: ve a CMS.
En el menú de la izquierda, selecciona Integrations y luego Twilio. Verás un panel con dos entradas: account_sid y auth_token. Twilio aparece como “Required” porque, sin esto, las funciones de telefonía no funcionarán.

​
Paso 2: Obtén tus credenciales en Twilio

Inicia sesión en tu Twilio Console.
En el Dashboard del proyecto, verás tu Account SID y Auth Token en “Project Info” (el token puede estar oculto; haz clic en “show” para verlo). Copia ambos valores. Asegúrate de usar las credenciales live, no las de test. Ejemplos:
Account SID: YOUR_ACCOUNT_SID
Auth Token: YOUR_AUTH_TOKEN Tip: trata el Auth Token como una contraseña. No lo compartas por email o chat.

​
Paso 3: Añade las claves en el CMS

En la sección de Twilio dentro del CMS:
Haz clic en Add API Key. Introduce los datos del Account SID exactamente así:
  • Key Name: account_sid (valor por defecto – no lo cambies)
  • Key Value: YOUR_ACCOUNT_SID
  • Description: Twilio Account SID
  • Active: marcado
Guarda con Save Key. Repite el proceso para el Auth Token:
  • Key Name: auth_token (valor por defecto – no lo cambies)
  • Key Value: YOUR_AUTH_TOKEN
  • Description: Twilio Auth Token
  • Active: marcado
Guarda con Save Key. Notas importantes:
  • Los nombres de las claves deben mantenerse exactamente como account_sid y auth_token (todo en minúsculas, con guion bajo).
  • Marca siempre ambas claves como Active. Si una de las dos está inactiva, la integración no funcionará.

​
Paso 4: Verifica que la integración está activa

Tras guardar, verás ambas claves listadas con estado Active. Comprobaciones rápidas:
  • Refresca la página de Integrations y confirma que Twilio no muestra avisos.
  • Si ya tienes un agente configurado, ejecuta una llamada de prueba desde la sección Agents. Si la llamada conecta, Twilio está correctamente integrado.

​
Configuración avanzada (opcional)

  • Rotación de token: si sospechas que tu Auth Token pudo exponerse, genera uno nuevo en Twilio y actualízalo inmediatamente en el CMS.
  • Subaccounts: si gestionas varios entornos o clientes, puedes usar un Twilio subaccount SID y token separado por proyecto para mantener facturación y uso aislados.
  • Buenas prácticas de seguridad: guarda el Auth Token en un gestor de contraseñas, limita quién puede verlo y controla el acceso a tu Twilio Console.

​
Errores comunes y soluciones

  • Claves inactivas: tanto account_sid como auth_token deben estar en Active.
  • Cambiar nombres de claves: deben quedar exactamente account_sid y auth_token. Cualquier variación rompe la integración.
  • Copiar/pegar con espacios: asegúrate de que no haya espacios al inicio o final de los valores.
  • Usar credenciales de test: en producción se requieren credenciales live.
  • Olvidar guardar: siempre haz clic en Save Key después de introducir los valores.
  • Token regenerado no actualizado: si regeneras el Auth Token en Twilio pero no lo actualizas en el CMS, las llamadas fallarán.

​
Comunicación fiable con Twilio

Una vez conectado, tu aplicación puede hacer llamadas y enviar SMS de forma fiable. Mantén tus claves activas, seguras y actualizadas, y tendrás una base sólida para escalar tus flujos de comunicación.