La API de WhatsApp Business con Twilio: Prácticas recomendadas y preguntas frecuentes
Con Twilio Programmable Messaging (mensajería programable de Twilio), puedes integrar los mensajes de WhatsApp en tu aplicación web. Aunque, en general, estas integraciones son sencillas, a menudo nos preguntan sobre la mejor manera de utilizar la API de mensajería programable específicamente para WhatsApp. También encontramos algunos patrones comunes y prácticas recomendadas que te harán enviar mensajes de WhatsApp antes.
A continuación, encontrarás las respuestas a estas preguntas frecuentes y algunas de nuestras prácticas recomendadas para la integración de la API de WhatsApp Business con Twilio.
Preguntas frecuentes
General
- ¿Cuáles son los requisitos a fin de que una empresa sea aprobada para WhatsApp?
WhatsApp requiere el cumplimiento de los Términos de la solución de WhatsApp Business, con la Política de soluciones de WhatsApp Business y con su Política de comercio. Como parte del proceso de aprobación, se considerará el caso de uso y empresarial para asegurarse de que el uso esté de acuerdo con las pautas anteriores. - ¿Cuál es el costo del servicio de WhatsApp?
El servicio de WhatsApp se cobra por tarifa de mensaje. Meta también cobra cargos por período de 24 horas por cada conversación que Twilio te transmite. Existen dos tipos de conversaciones: Conversaciones iniciadas por negocios y conversaciones iniciadas por el usuario. Puedes encontrar más información sobre el costo de enviar mensajes de WhatsApp aquí. - ¿Cómo puedo administrar las listas de acceso separadas del Sandbox y a los números en vivo de mi cuenta?
Si tienes la necesidad de segmentar el tráfico y administrar las listas de acceso separadas, te recomendamos que dividas el tráfico entre diferentes cuentas de Twilio. Esto te permitirá tener un mejor control sobre cada uno de estos casos de uso y te permitirá administrar las listas de acceso separadas para cada cuenta. - ¿Cuál es el límite de MPS (mensajes por segundo) para los mensajes salientes de WhatsApp?
La API de WhatsApp Business con Twilio tiene un rendimiento de mensajería máximo de 25 MPS (mensajes por segundo) por remitente para tráfico saliente que contiene solo texto. El rendimiento máximo para el tráfico saliente que contiene archivos de medios es de 1,5 MPS.
Cuando tu aplicación envía mensajes de WhatsApp a Twilio a una tasa que excede los límites anteriores, Twilio mantiene una cola y envía mensajes de esta cola a las respectivas velocidades de 25 MPS y 1,5 MPS para mensajes de texto y mensajes que contienen medios (consulta la guía sobre los tipos de archivos compatibles). Esta cola de mensajes tiene un límite máximo de cuatro horas. Los mensajes que permanecen en la cola por más de cuatro horas fallarán. Se rechazarán y fallarán los mensajes nuevos que harán que la cola se retrase más allá del límite de tiempo de cuatro horas.
Muchos factores pueden afectar la tasa real a la que se entregan los mensajes de WhatsApp a los destinatarios finales. Los ejemplos incluyen el envío de archivos de medios de gran tamaño, el envío de altos volúmenes de archivos medios únicos a cada usuario destinatario, el envío de mensajes que contengan URL a sitios web con tiempos de carga prolongados, la recepción de mensajes entrantes simultáneos en el mismo número de WhatsApp que envía notificaciones salientes y una alta latencia de red entre los servidores y los usuarios destinatarios. Para evitar la acumulación inesperada de colas y las altas cantidades de errores de los mensajes, se recomienda no enviar solicitudes de mensajes en tasas iguales o superiores a los límites mencionados anteriormente durante períodos prolongados.
Para lograr una mayor MPS en tus necesidades de envío, puedes utilizar los Servicios de mensajería. Esto te permite distribuir grandes volúmenes de mensajes entre muchos remitentes dentro de un servicio de mensajería.
Si tienes requisitos de alto rendimiento para su caso de uso, comunícate con nuestro equipo de soporte para obtener orientación sobre las prácticas recomendadas y asistencia sobre tus requisitos individuales.
- Mi implementación es para el mercado europeo. ¿La API cumple con el GDPR?
Twilio está comprometido con el cumplimiento del GDPR. Ofrecemos los términos del Contrato de protección de datos listos para el GDPR. Para agregar un apéndice de protección de datos adecuado, completa nuestra Solicitud de apéndice de protección de datos del GDPR de Twilio.
Sandbox
- ¿Por qué recibo un mensaje de “tu número no está asociado con el canal del sandbox”?
Asegúrate de seguir con cuidado las instrucciones de la sección Usar números de teléfono con WhatsApp de la referencia y descripción general de la API de mensajería programable. Tendrás que unirte a un sandbox y habilitar uno de tus números Twilio con WhatsApp. - ¿Por qué cuando intento enviar un mensaje recibo un mensaje de “Twilio no pudo encontrar un canal con la dirección de origen especificada”?
Hay dos razones comunes por las que ves este error:- La dirección
From
(Desde) en tu solicitud de la API de mensajería programable es incorrecta. Para enviar mensajes mediante WhatsApp, la direcciónFrom
(Desde) debe serwhatsapp:<sandbox phone number>
. Esto se puede encontrar en la página del sandbox aquí. - Estás intentando enviar un mensaje desde una cuenta que no tiene instalado ese sandbox. Activa el sandbox antes de enviar un mensaje.
- La dirección
- Me uní al sandbox de Twilio para WhatsApp y obtuve una respuesta de “Sandbox de Twilio. ¡Ya está todo listo! El sandbox xyz puede enviar o recibir mensajes...”. ¿Puedo cambiar el mensaje?
Esta respuesta es parte de nuestra implementación del sandbox y no se puede cambiar. Una vez que obtengas tu propio número, puedes establecer tu propio mensaje. Ten en cuenta que WhatsApp requiere que las marcas reciban la suscripción de clientes antes de enviar mensajes en WhatsApp. - Mi mensaje saliente del sandbox no se entregó. ¿Por qué?
Hay dos razones por las que un mensaje enviado desde el Sandbox de Twilio para WhatsApp no se entregará:- Estás intentando enviar un mensaje a un usuario que no se ha unido a tu sandbox. Consulta nuestras instrucciones para comenzar con el sandbox, incluida la forma en que los usuarios pueden unirse a tu espacio aislado.
- Estás enviando un mensaje de formato libre al usuario fuera de la sesión de WhatsApp. Una sesión de WhatsApp dura 24 horas después del último mensaje entrante que recibes de un usuario. Fuera de una sesión de WhatsApp, solo puedes enviarle al usuario un mensaje de plantilla aprobado previamente (para obtener más detalles, consulta sobre los mensajes de plantilla); Twilio enviará cualquier mensaje que no coincida con una plantilla preaprobada como un mensaje de formato libre. Puedes encontrar una lista de plantillas preaprobadas para el sandbox aquí.
Preguntas específicas de la API
- ¿Puedo comprobar si el número de teléfono de un usuario está habilitado para WhatsApp?
Cada vez que envíes un mensaje de WhatsApp, Twilio comprueba de forma automática si el número está habilitado para WhatsApp y si el destino que se encontró no es válido, el mensaje tendrá un error con el código de error 63003. WhatsApp tiene pautas estrictas cuando se trata de comprobar la disponibilidad. Cuando se encuentra un número de WhatsApp válido, es necesario realizar un seguimiento con un mensaje a fin de evitar que la cuenta se marque para un tráfico de menor calidad. WhatsApp no permite exponer la comprobación de capacidad y utilizarla independiente de enviar un mensaje. - ¿Qué opciones de formato tengo en WhatsApp?
Consulta nuestra guía de funciones de mensajería enriquecidas, incluido el formato, en la API de WhatsApp Business con Twilio. - ¿Puedo enviar mensajes a los grupos de WhatsApp o administrar grupos?
WhatsApp dejo obsoleta la API de grupos en abril del 2020. Twilio ofrece una solución de mensajería de grupo mediante la API de Conversations. Puedes hacer referencia a este código de muestra en CodeExchange: Mensajería de grupo de WhatsApp. Para obtener más información, consulta Twilio Conversations. - ¿La API de WhatsApp Business con Twilio admite recibos de lectura?
Twilio admite recibos de lectura en mensajes iniciados por el negocio. En la actualidad, Twilio no admite recibos de lectura para los mensajes entrantes (iniciados por el usuario) de WhatsApp. Esto significa que no es posible que el negocio establezca el estado de un mensaje que recibió en "read" (leído) (es decir, cambiar el color de la marca de verificación en la aplicación del usuario final).
Números de teléfono en vivo
- ¿Qué casos de uso son compatibles con WhatsApp?
WhatsApp admite mensajería iniciada por el usuario e iniciada por el negocio. Con los mensajes iniciados por el usuario, el negocio recibe el primer mensaje del usuario. Esto abre una conversación en la que el negocio puede responder con mensajes de formato libre. La conversación permanece abierta durante 24 horas después del último mensaje recibido del usuario.
Los mensajes iniciados por el negocio se dan cuando el negocio envía el primer mensaje al usuario, o responde al usuario más de 24 horas después del último mensaje recibido del usuario. Esto generalmente se aplica a los casos de uso de notificaciones. Los mensajes iniciados por el negocio requieren el uso de plantillas preaprobadas. - ¿Qué opciones de tipo de cuenta tengo para mi negocio en WhatsApp? ¿Cómo aparecen en la app?
Puedes encontrar información sobre los tipos de cuentas disponibles de WhatsApp aquí. Puedes solicitar una cuenta comercial oficial una vez que tu número esté activo y la cuenta de FB Business Manager que está vinculada a tu número de WhatsApp está establecida en el estadoVerified
(Verificado). - ¿Qué tipo de números de teléfono se pueden habilitar para WhatsApp?
WhatsApp requiere un número de teléfono que cumpla con E.164 y que pueda recibir un código OTP (un PIN único) mediante SMS o una llamada telefónica (para activar el servicio). La mayoría de los números vendidos en Twilio son compatibles. Puedes encontrar más información aquí.
Configuración de un perfil de Business
- ¿Cuál es el proceso a fin de establecer un número en vivo para WhatsApp?
Consulta nuestra guía paso a paso para configurar y conectar un perfil de WhatsApp Business a tu número de teléfono Twilio.
Compatibilidad de medios
- ¿Cómo puedo enviar y recibir medios en WhatsApp? ¿Qué tipo de medios son compatibles?
Puedes encontrar información sobre cómo enviar y recibir mensajes de medios y otros medios compatibles en WhatsApp aquí. También tenemos un tutorial paso a paso más detallado para enviar y recibir medios en WhatsApp.
Solución de problemas de los códigos de error de WhatsApp
- Recibo el código de error 63020 cuando intento enviar mensajes en WhatsApp. ¿Qué debo hacer?
El error 63020 indica que aún debes aceptar la invitación de Twilio para enviar mensajes en tu nombre en el negocio. Dirígete a tu cuenta de FB Business Manager y acepta la invitación para poder enviar y recibir mensajes. - Todo salió bien hasta que comencé a recibir el código de error 63018 cuando intento enviar mensajes. ¿Por qué?
El error 63018 indica que has alcanzado el límite de frecuencia establecido en tu número de WhatsApp. Puedes obtener más información sobre el límite de frecuencia de WhatsApp y cómo planificar tu implementación aquí.
¿Necesitas ayuda?
Todos la necesitamos a veces; la programación es difícil. Obtén ayuda ahora de nuestro equipo de soporte, o recurre a la sabiduría de la multitud visitando Stack Overflow Collective de Twilio o navegando por la etiqueta de Twilio en Stack Overflow.