Conectar un número de WhatsApp de tu cuenta de Twilio

Si tu número de WhatsApp está en tu propia cuenta de Twilio, lo conectas desde Canales › Conectar WhatsApp › Tengo mi número en Twilio con tres datos: el Account SID, el Auth Token y el número. Los mensajes los sigues pagando a Twilio; en iAgentify no tienen coste adicional por mensaje.

Antes de empezar

Necesitas el rol Administrador o Propietario, un plan que incluya WhatsApp y un agente que todavía no tenga número: mira lo que vale para las tres formas. De tu consola de Twilio (se abre en otra web) necesitas:

• El Account SID. Está en el apartado «Account Info» de la página de inicio de la consola. Empieza por AC.
• El Auth Token principal de la cuenta. Está en el mismo apartado. Una clave de API no sirve: Twilio firma con ese token los mensajes que entrega a iAgentify. Se guarda cifrado y no se vuelve a mostrar.
• Un número ya aprobado como remitente de WhatsApp, con el estado «Online». Lo ves en Twilio, en Messaging → Senders → WhatsApp senders, la lista de números dados de alta para WhatsApp. Si no aparece como «Online», termina antes su registro en Twilio.

Conecta el número

1. Entra en Canales y, en WhatsApp, pulsa Conectar WhatsApp. Si ya tienes un número conectado, el botón se llama Conectar otro número.

2. En Agente, elige el agente que responderá a los mensajes que lleguen al número.

3. En Cómo quieres conectarlo, pulsa Tengo mi número en Twilio.

4. Pega el Account SID.

5. Pega el Auth Token.

6. En Número de WhatsApp, escribe el número en formato internacional, por ejemplo +34 600 111 222.

7. Pulsa Conectar número. iAgentify comprueba los datos con Twilio y muestra «Número conectado».

8. Mira qué pone en Webhook. El webhook es la dirección a la que Twilio envía cada mensaje que recibe tu número, y tiene que ser la de iAgentify.

   • «Configurado por iAgentify. No tienes que hacer nada más.»: pulsa Hecho.
   • «Tienes que pegarlo tú en Twilio»: sigue los pasos del webhook.

9. Envía un mensaje de WhatsApp al número desde otro teléfono. Con el agente Activo, la respuesta llega en unos segundos y la conversación aparece en Conversaciones.

Si tienes que pegar el webhook en Twilio

Hasta que lo hagas, los mensajes de tus clientes no llegarán al agente.

1. Pulsa Copiar junto a Dirección del webhook. La dirección queda también en la tarjeta del número, en Canales.

2. En Twilio, ve a Messaging → Senders → WhatsApp senders y abre tu número.

3. Pega la dirección en «Webhook URL for incoming messages», con el método POST, y también en «Status callback URL». Guarda los cambios en Twilio.

Mientras no llegue ningún mensaje, la tarjeta del número muestra «Falta configurar el webhook en Twilio».

Probar con el sandbox de Twilio

Para probar sin un número aprobado puedes usar el sandbox de WhatsApp de Twilio, un número de pruebas que Twilio comparte entre sus cuentas.

1. En Twilio, ve a Messaging → Try it out → Send a WhatsApp message y activa el sandbox.

2. Desde el teléfono que hará de cliente, envía al número del sandbox el mensaje join seguido de tu código, tal como lo muestra Twilio en esa página.

3. En iAgentify, sigue los pasos de arriba y, bajo Número de WhatsApp, pulsa Usar ese número.

4. Copia la Dirección del webhook de la pantalla de resultado. Con el sandbox siempre hay que pegarla a mano.

5. En Twilio, ve a Messaging → Try it out → Send a WhatsApp message → Sandbox settings. Pega la dirección en «When a message comes in», con el método POST, y también en «Status callback URL».

6. Envía un mensaje desde el teléfono que se unió.

Sus límites los pone Twilio:

• Es solo para pruebas. No lo uses con clientes.
• Solo escribe a los teléfonos que han enviado el mensaje de unión, y esa unión caduca a los tres días. Después hay que enviar de nuevo el join.
• Solo un agente de toda la plataforma puede tenerlo conectado a la vez. Si al conectarlo ves «Este número ya está conectado a un agente.», lo está usando otra cuenta.

En Canales aparece con la etiqueta Sandbox de Twilio.

Qué cuesta

Los mensajes los sigues pagando a Twilio, con las tarifas de tu cuenta de Twilio. En iAgentify no tienen coste adicional por mensaje: cada respuesta del agente gasta sus créditos normales, igual que en el chat de tu web, y las respuestas que escribe una persona desde Conversaciones no gastan créditos.

Errores al conectar y qué hacer

Si más adelante la tarjeta del número muestra Con error, Twilio ha rechazado el Auth Token guardado, la cuenta está suspendida o el número ya no es un remitente de WhatsApp de esa cuenta. Revísalo en Twilio; después desconecta el número y vuelve a conectarlo con el Auth Token actual.

Desconectar el número

1. En Canales, pulsa Desconectar en la tarjeta del número.

2. Lee el aviso y confirma. El agente deja de recibir y responder mensajes en ese número.

Las conversaciones ya guardadas se conservan. En Twilio no cambia nada: el número seguirá enviando los mensajes a iAgentify, que los rechazará, hasta que cambies allí el webhook.

Si un mensaje se queda sin respuesta, las causas están en un mensaje de WhatsApp se ha quedado sin respuesta.