Twilio para WhatsApp

Twilio es un proveedor de comunicaciones que da acceso a WhatsApp a través de sus propias APIs, con la ventaja de un sandbox que permite probar en minutos sin esperar a aprobaciones de número, y de unificar WhatsApp con SMS, voz y otros canales bajo una misma cuenta y un mismo SDK. Es una buena vía si ya usas Twilio para algo más, o si quieres desarrollar con buen tooling y documentación abundante sin lidiar de forma directa con la consola de Meta.

Twilio ofrece dos APIs distintas que conviene diferenciar desde el principio. Programmable Messaging está pensada para envíos individuales y notificaciones (alertas, OTP, transaccionales). Conversations API gestiona el hilo bidireccional con estado: contacto, participantes, historial, adjuntos. Elegir bien al principio evita refactorizaciones desagradables.

Le rinde a equipos de desarrollo que valoran tooling maduro y SDKs en muchos lenguajes, y a empresas que ya tienen Twilio para SMS u OTP y quieren añadir WhatsApp sin cambiar de proveedor.

Por qué importa

Antes de Twilio, integrar WhatsApp Business significaba pelearse directamente con la documentación de Meta y montar la capa de envío y recepción desde cero. Para equipos sin experiencia previa con APIs de mensajería, el camino era largo y propenso a errores.

Con Twilio, gran parte de esa complejidad queda absorbida. El sandbox permite mandar el primer mensaje en cinco minutos y las APIs están bien documentadas con ejemplos en los lenguajes habituales. Para conversaciones complejas o flujos de OTP, hay productos específicos (Conversations API, Verify API) que resuelven patrones recurrentes sin reinventar la rueda.

Cómo se usa en la práctica

El primer paso es crear una cuenta en Twilio. El registro es directo y, tras verificar el email, entras a la consola. Allí, en la sección Messaging, encuentras el apartado WhatsApp con un acceso destacado al sandbox.

El WhatsApp Sandbox es el atajo para prototipar. Twilio te asigna un número propio para pruebas y un código corto que tienes que enviar desde tu WhatsApp personal a ese número (algo del tipo “join palabra-palabra”). En cuanto tu teléfono queda registrado en el sandbox, puedes mandar y recibir mensajes con la API real, sin esperas, sin verificación de empresa, sin trámites con Meta. Sirve para tener un primer envío funcionando en minutos y validar la lógica de tu aplicación antes de hacer el papeleo serio.

Las credenciales clave para llamar a la API son el Account SID y el Auth Token, ambos visibles en el panel principal de Twilio. Con esas dos cadenas y el SDK del lenguaje que uses (Node, Python, Java, PHP, .NET, Go y otros) puedes mandar tu primer mensaje en pocas líneas. La consola incluso muestra ejemplos pegables ya rellenados con tus datos.

Para mensajes entrantes hay que configurar un Webhook: una URL pública de tu aplicación a la que Twilio mandará un POST cada vez que llegue un mensaje. En desarrollo local conviene usar herramientas tipo ngrok; en producción, una URL HTTPS estable.

El salto a producción exige registrar un remitente real con el WhatsApp Self Sign-up de Twilio. Conecta un número de teléfono que tú controles con tu cuenta de Meta Business, gestiona la verificación y aprueba el remitente para uso comercial. Una vez aprobado, dejas de depender del sandbox.

Las plantillas son el otro componente crítico. Cualquier mensaje fuera de la ventana de 24 horas desde el último mensaje del usuario tiene que ser una plantilla aprobada por Meta. Twilio gestiona la creación, envío a aprobación y uso con variables desde su consola.

Para casos específicos, Twilio ofrece productos preconstruidos. Verify API maneja flujos de OTP por WhatsApp y otros canales sin que tengas que armar la lógica de generación de códigos, expiración y reintentos.

Casos de uso reales

Una plataforma SaaS que ya usa Twilio para enviar SMS de OTP decide añadir WhatsApp como segundo canal de entrega. El cambio es mínimo en su código: la misma Verify API, un parámetro distinto para indicar el canal, y a los pocos minutos los usuarios pueden recibir el OTP por WhatsApp si así lo prefieren. Sin nuevo proveedor, sin nuevo SDK, sin nueva facturación.

Un desarrollador independiente quiere prototipar un bot de WhatsApp para un cliente sin esperar a que se complete la verificación de la empresa en Meta. Con el sandbox de Twilio, monta el bot en una tarde, lo demuestra al cliente desde su propio móvil y, una vez aprobado el proyecto, arranca el self sign-up para producción con la lógica ya validada.

Un ecommerce monta notificaciones transaccionales (confirmación de pedido, envío, entrega) usando Programmable Messaging con plantillas aprobadas. Cada vez que el estado del pedido cambia en su sistema, dispara una llamada a Twilio que rellena las variables de la plantilla correspondiente. Los clientes reciben la actualización en su WhatsApp con el formato corporativo aprobado.

Una empresa con un equipo de atención al cliente monta un sistema de conversaciones bidireccionales con Conversations API. Cada cliente tiene un hilo permanente con la marca y varios agentes pueden tomar turnos en la conversación sin perder contexto. Twilio gestiona la complejidad del estado y el equipo solo se preocupa de la lógica de negocio sobre encima.

Errores comunes y cómo evitarlos

• Olvidar el prefijo whatsapp: en los números. Tanto el From como el To de la API requieren ese prefijo. Sin él, la llamada falla o se enruta como SMS.
• Usar el sandbox para clientes reales. El sandbox solo manda a números que se hayan unido con el código corto. Si pones el sandbox en producción, los clientes verán que su número del remitente es el del sandbox y los mensajes solo llegarán a quienes hayan hecho el opt-in manual.
• Elegir mal entre Programmable Messaging y Conversations. Si tu caso es bidireccional con estado, montarlo sobre Programmable Messaging te obliga a reinventar la rueda. Si tu caso son notificaciones puntuales, Conversations es más pesada de lo necesario.
• Ignorar la ventana de 24 horas. Fuera de ese plazo desde el último mensaje del usuario hace falta plantilla aprobada, sin excepciones. Es regla de WhatsApp, no de Twilio.
• Subestimar los costes en dos capas. Pagas lo que cobra Meta por categoría de conversación más el cargo de Twilio por mensaje. Modeliza ambos antes de comprometer un caso de uso masivo.
• No proteger el Auth Token. Filtrar el Auth Token en un repositorio o cliente público da control total de tu cuenta a quien lo encuentre. Variables de entorno y rotación periódica son mínimos básicos.

Cuándo NO usarla

Si buscas el menor coste por mensaje y tienes equipo técnico cómodo con la documentación de Meta, la Cloud API directa sale más barata porque te ahorras el cargo del intermediario. Si tu caso es completamente no-código (una pyme que solo quiere atender por WhatsApp con bandeja y bots visuales sin programar), WATI o respond.io encajan mejor.

Tampoco es ideal si quieres acceso oficial sin recargo pero sin renunciar a un trato cercano de partner. En ese caso, 360dialog se especializa justo en ese hueco: BSP oficial, sin markup, con onboarding asistido.

Combinarla con otras herramientas

Twilio se integra de forma natural con cualquier stack moderno: backends en Node o Python, plataformas serverless como AWS Lambda o Cloudflare Workers, herramientas de orquestación tipo Zapier o n8n y CRMs vía Webhooks. Su API es lo bastante estándar como para conectar con casi cualquier sistema sin esfuerzo. Para flujos visuales sin código, Twilio Studio (incluido en la plataforma) permite montar conversaciones con bloques arrastrables que llaman a las mismas APIs por debajo.

Mini-ejercicio

Crea una cuenta gratuita en Twilio, activa el WhatsApp Sandbox y une tu propio número enviando el código corto desde tu teléfono. Después, instala el SDK de Twilio en el lenguaje que prefieras y manda un mensaje saliente a tu propio número usando el From del sandbox y tu número personal como To. Comprueba en tu WhatsApp que el mensaje llega.

Sabrás que está bien si recibes el mensaje en tu móvil con el texto que enviaste desde el código, sin tocar la consola de Twilio más allá del alta inicial y la activación del sandbox.