Configurar el webhook de SMS (Twilio) para recibir mensajes

Conecta tu número de Twilio a Omnifox y apunta su webhook de mensajería para que cada SMS entrante abra una conversación en el Inbox.

Jun 25, 2026

Qué vas a lograr

El canal SMS usa Twilio para enviar y recibir mensajes de texto. Para recibir, hay que decirle a Twilio a qué dirección avisar cuando llega un SMS: esa es la URL de webhook entrante de Omnifox. Una vez conectado, cada mensaje abre una conversación en el Inbox.

Requisitos

  • Una cuenta de Twilio con un número habilitado para SMS.
  • El Account SID y el Auth Token de tu panel de Twilio.
  • El número en formato E.164 (con prefijo +, p. ej. +15551234567).

Pasos

  1. En Omnifox ve a Canales y pulsa Conectar canal.
  2. Elige SMS (Twilio) en la lista.
  3. Pega tu Account SID y tu Auth Token, y escribe el Número de teléfono en E.164.
  4. Copia la Webhook URL que muestra Omnifox: https://omnifox.io/api/webhooks/sms.
  5. Guarda el canal.
  6. Entra a la consola de Twilio: Phone Numbers → Manage → Active Numbers → elige tu número.
  7. En la sección Messaging, en "A message comes in", selecciona Webhook, pega la URL del paso 4 y deja el método en HTTP POST.
  8. Guarda los cambios en Twilio.

Cómo verificar

Desde otro teléfono, envía un SMS al número de Twilio. En segundos debería aparecer una nueva conversación en el Inbox de Omnifox con el texto del mensaje, y el remitente queda como contacto. Responde desde el Inbox para confirmar el envío de vuelta.

Si no funciona

  • El SMS no llega al Inbox: revisa que la Webhook URL en Twilio sea exactamente https://omnifox.io/api/webhooks/sms y que el método sea POST, no GET.
  • Twilio reporta error 11200 / 403: Omnifox valida la firma de Twilio (cabecera X-Twilio-Signature). Asegúrate de que el Auth Token guardado en el canal sea el correcto y vigente; si lo rotaste en Twilio, actualízalo en el canal.
  • No enruta: Omnifox identifica el canal por el número destinatario (tu número de Twilio). Verifica que el número del canal coincida con el que recibe el SMS.

Tips

  • Si usas un Messaging Service de Twilio en lugar de un número suelto, configura el webhook entrante a nivel del servicio apuntando a la misma URL.
  • Mantén el Auth Token sincronizado: rotarlo en Twilio sin actualizar el canal rompe la verificación de firma y los mensajes dejan de entrar.

Artículos relacionados

¿Te fue útil?

Artículos relacionados

Escríbenos por WhatsApp