Your AI Connector Docs

Proveedor de SMS (Trae tu propio Twilio)

Esta página controla la cuenta de Twilio utilizada para la API de WhatsApp Business. De forma predeterminada, la API de WhatsApp Business se ejecuta en la cuenta de Twilio gestionada por la plataforma; nunca verá Twilio y no necesita registrarse en Twilio por su cuenta. Si ha conectado su propia clave de Anthropic (BYOK), los mensajes de WhatsApp de Twilio gestionado cuestan 0.05 créditos cada uno, tanto entrantes como salientes. En cualquier otra cuenta, esos costes de entrega ya están cubiertos por su tarifa de créditos de IA, por lo que no hay un cargo separado por mensaje. (Los precios de los mensajes de WhatsApp cambiarán el 1 de octubre de 2026; consulte Costes de WhatsApp y el cambio de octubre de 2026.) Esto solo es relevante si desea específicamente que la API de WhatsApp Business se ejecute en su propia cuenta de Twilio.

SMS siempre requiere traer su propia cuenta de Twilio (Bring Your Own Twilio). La regulación de SMS (A2P 10DLC, registro de marca, aprobación de ID de remitente) debe presentarse a nombre de su propia empresa, por lo que la plataforma no ofrece números SMS administrados. Configure los SMS por separado utilizando la tarjeta SMS vía Twilio en Configuración → Canales (también existe una opción de puerta de enlace SMS para teléfonos Android). Esta página, la tarjeta Cuenta de Twilio, controla la cuenta de la API de WhatsApp Business y no cambia su número de SMS.

¿Por qué cambiaría la API de WhatsApp Business a mi propio Twilio?

La mayoría de los usuarios no lo haría. La cuenta administrada es más sencilla:

  • El alquiler de números de WhatsApp, el envío de plantillas, el registro del remitente y el estado del número se gestionan por usted. Un número alquilado aquí cuesta al menos 50 créditos al mes, y ese alquiler incluye la conexión de WhatsApp; consulte Números de teléfono.
  • No hay una factura de Twilio por separado. Si ha conectado su propia clave de Anthropic (BYOK), los mensajes de WhatsApp de Twilio gestionado cuestan 0.05 créditos cada uno, tanto entrantes como salientes. En cualquier otra cuenta, esos costes de entrega ya están cubiertos por su tarifa de créditos de IA, por lo que no hay un cargo separado por mensaje. Consulte Costes de WhatsApp y el cambio de octubre de 2026 para conocer el cambio de precios de WhatsApp que entrará en vigor el 1 de octubre de 2026.
  • El soporte técnico puede ayudar a depurar problemas de entrega directamente.

Es posible que desees traer tu propio Twilio si:

  • Ya tiene una cuenta de Twilio establecida con plantillas de WhatsApp aprobadas y números activos que desea seguir usando.
  • Su empresa tiene una razón de adquisición o cumplimiento para pagar directamente a Twilio.
  • Desea una visibilidad total del uso y los precios a nivel de operador subyacente.

Mantener un número ya activo es una tarea de dos pasos. Cambiar la cuenta (ver abajo) solo modifica la cuenta de Twilio a través de la cual enviamos los mensajes. Tu número de WhatsApp existente no aparecerá como canal hasta que también lo vincules; consulta Vincular un número de WhatsApp que ya tienes. Realízalo en ese orden.


Cómo cambiar

Cómo llegar: Configuración → grupo CanalesCanales, luego busque la tarjeta Cuenta de Twilio.

Lo que veas dependerá de tu configuración actual:

Si estás en la cuenta administrada (predeterminada)

Verá una breve explicación y un botón Administrar en la tarjeta de Cuenta de Twilio. Al hacer clic en él, se abre el formulario Cambiar a su propia cuenta de Twilio, que solicita su SID de cuenta y Token de autenticación de Twilio, con la advertencia de acción destructiva que se muestra directamente en el cuadro de diálogo.

Antes de confirmar, lee las advertencias detenidamente; el cambio es destructivo:

  • Todos los números que compró a través de la plataforma se liberarán permanentemente. Si desea seguir usando un número, manténgalo en la cuenta administrada (no cambie) o cómprelo/transfiéralo primero a su propia cuenta de Twilio.
  • Las plantillas de WhatsApp aprobadas no se transferirán. Las plantillas residen en la cuenta de WhatsApp Business que posee el remitente; deberá volver a enviarlas en su propia cuenta y esperar a que se vuelvan a aprobar.
  • Los chats y el historial de mensajes existentes permanecen visibles, pero las nuevas respuestas en los números liberados fallarán (el número ya no existe).
  • Puede volver a cambiar más tarde, pero obtendría una cuenta administrada nueva sin números ni plantillas; sus antiguos no regresarán.

Dónde encontrar su SID de cuenta y Token de autenticación: inicie sesión en la consola de Twilio en console.twilio.com. Ambos están en el panel principal, en el panel “Información de la cuenta”. El SID de la cuenta comienza con AC y tiene 34 caracteres de longitud.

Después de ingresar ambos valores y confirmar, el sistema:

  1. Valida que las credenciales funcionen.
  2. Libera cada número de teléfono administrado de Twilio.
  3. Cierra la subcuenta administrada.
  4. Guarda sus credenciales para que todos los futuros envíos de WhatsApp utilicen su cuenta. Su número de SMS vía Twilio conectado por separado se almacena de forma independiente y no se libera ni cambia con este cambio.

Esto puede tardar desde unos pocos segundos hasta un par de minutos si tenía varios números.

Si ya estás en tu propia cuenta de Twilio

La tarjeta muestra su cuenta conectada y le permite volver a la configuración administrada.

Volver a la configuración administrada aprovisiona una nueva subcuenta administrada. Como se mencionó anteriormente: esto no restaura los números o plantillas que tenías antes; empezarías desde cero.


Vincular un número de WhatsApp que ya tienes

Una vez que la cuenta está en su propio Twilio, el botón Conectar WhatsApp en la tarjeta de la API de WhatsApp Business cambia lo que ofrece: la opción gestionada se convierte en A través de su cuenta de Twilio, lo que adjunta un remitente de WhatsApp dentro de la cuenta de Twilio que conectó, y ya no se ofrece la compra de un número gestionado. Esto es deliberado: comprar un número o realizar el registro en Meta crearía una segunda cuenta de Twilio gestionada por la plataforma junto a la suya, y sus mensajes se enviarían desde una cuenta mientras el número reside en la otra.

Antes de empezar

Tu número debe ser ya un remitente de WhatsApp funcional dentro de tu propia cuenta de Twilio:

  • Está registrado como remitente de WhatsApp en Twilio, vinculado a tu propia cuenta de WhatsApp Business.
  • Twilio muestra ese remitente como En línea.

Esta pantalla no registra nada. No crea un remitente, no se comunica con Meta y no envía tu número para su aprobación; simplemente conecta un remitente que ya funciona. Si aún no tienes uno, realiza primero la configuración del remitente de WhatsApp en Twilio.

Pasos

  1. Ve a Configuración → grupo CanalesCanales.
  2. En la tarjeta WhatsApp Business API, haz clic en Vincular tu remitente.
  3. Introduce el número de WhatsApp en formato internacional (por ejemplo, +31612345678), exactamente como aparece en el remitente en Twilio.
  4. Opcionalmente, asígnale una Etiqueta: un nombre para el número dentro de la aplicación. Si se deja en blanco, utilizará el nombre del perfil de tu remitente en Twilio.
  5. Haz clic en Vincular remitente.

No necesitas volver a introducir tu Account SID o token de autenticación: ya los tenemos tras el cambio de cuenta.

Qué sucede entre bastidores

  1. Buscamos el remitente para ese número en su cuenta de Twilio y verificamos que Twilio lo tenga en línea.
  2. Nos aseguramos de que exista un servicio de mensajería en su cuenta y apuntamos su webhook de entrada hacia nosotros (creando uno, con el nombre de la aplicación, si aún no tiene uno). Esto es también lo que permite que funcione el envío de plantillas.
  3. Vinculamos su remitente a ese servicio de mensajería.
  4. Apuntamos el propio webhook del remitente hacia nosotros, para que los mensajes entrantes lleguen aquí.
  5. El número aparece en su lista de números, marcado como Your Twilio (BYO), listo para asignarse a una campaña o agente.

Tus plantillas aprobadas permanecen exactamente donde están, en tu propia cuenta. Nada se vuelve a enviar y nada se libera.

Costes

No hay cargo de mantenimiento mensual por un número que vinculas de esta manera; pagas a Twilio directamente por el número y sus tarifas por mensaje. Las respuestas de IA siguen utilizando créditos de forma normal.

Si no funciona

  • “No WhatsApp sender for … exists in your Twilio account” — el número no está registrado como remitente de WhatsApp allí, o está escrito de forma diferente. Compruebe el ID de remitente exacto en la consola de Twilio y vuelva a introducirlo en formato internacional.
  • “The WhatsApp sender … is not online in Twilio” — el motivo propio de Twilio se incluye en el mensaje. Soluciónelo primero en Twilio; adjuntar un remitente que Twilio tiene desconectado solo provocaría un error más tarde, de forma silenciosa.
  • “… is already connected to another account” — el número está vinculado a una cuenta diferente aquí. Desconéctelo allí primero.
  • “This account is still on the managed Twilio account” — realice el cambio anterior primero.
  • “we could not update its webhook in Twilio” — el número está vinculado y enviará mensajes, pero el remitente sigue apuntando al webhook que tuviera configurado. Borre ese webhook en el remitente desde la consola de Twilio para que los mensajes entrantes nos lleguen.

Límites

  • Puede cambiar de proveedor como máximo una vez cada 24 horas. Esto evita que las rebotes repetidos acumulen costos de API de Twilio y límites de velocidad.
  • El envío de SMS no se ve afectado en absoluto por esta configuración; si ya ha conectado su propia cuenta de Twilio a través de la tarjeta SMS vía Twilio, esa es una conexión diferente y permanece donde está independientemente de lo que haga aquí.

¿Qué pasa si algo sale mal?

  • “No se pudo autenticar con las credenciales de Twilio proporcionadas” — verifique el SID (comienza con AC, 34 caracteres) y el token de autenticación. Ambos distinguen entre mayúsculas y minúsculas.
  • “La cuenta no está activa” — la cuenta de Twilio que intenta usar está suspendida o cerrada. Utilice una cuenta activa.
  • “Espere Xh antes de volver a cambiar” — se encuentra dentro del periodo de espera de 24 horas. Espere a que finalice.
  • Migración parcial (algunos números liberados, otros no) — vuelva a ejecutar el cambio. El sistema es idempotente; retoma el proceso donde se quedó y termina de liberar lo que aún esté en la subcuenta gestionada.

Si tienes problemas después de realizar el cambio (los mensajes salientes no se envían, las plantillas no aparecen), contacta al soporte técnico con tu Account SID (nunca con el auth token).


¿Necesita ayuda?

If you’re not sure whether switching is right for you, or run into trouble, contact support and we can help you decide.