Configuración del canal de WhatsApp (API)

💡 Próximamente: WhatsApp implementará nombres de usuario en julio de 2026

Cuando un Contacto adopte un nombre de usuario, su número de teléfono ya no se compartirá con tu empresa, por lo que WhatsApp introduce un nuevo identificador de Contacto: ID de usuario con alcance empresarial (BSUID). Respond.io gestionará esto automáticamente — las conversaciones continuarán con normalidad y los registros de Contacto permanecerán sin cambios.

Esto es lo que viene:
- Respond.io admitirá el nuevo identificador de Contacto, ID de usuario con alcance empresarial (BSUID), cuando no haya disponible un número de teléfono.
- El número de teléfono seguirá siendo el identificador principal si está presente y el envío de mensajes mediante el número de teléfono continuará funcionando con normalidad.
- Un nuevo botón Solicitar número de teléfono estará disponible para las plantillas de mensajes de Marketing y Utility — permitiendo que los Contactos compartan su número de teléfono directamente en la conversación.
- Para empresas integradas con CRM, el ID de usuario con alcance empresarial (BSUID) estará disponible en eventos de Webhook y en la API para Desarrolladores, listo para sincronizarse con tus integraciones de terceros. Esto se aplica a los Contactos nuevos creados después de abril de 2026.

¿Necesitas ayuda? Contacta al soporte o consulta la documentación de Meta.

Después de conectar tu Canal de la Plataforma de WhatsApp Business (API) a respond.io, usa la Configuración de Canal para gestionar el nombre del Canal, el perfil comercial, los tipos de archivo admitidos, los límites de velocidad de mensajería y las mejores prácticas para mantener tu Cuenta de WhatsApp Business (WABA) en buen estado con Meta.

Configurar el nombre del Canal de WhatsApp

Asigna un nombre de Canal interno único para identificar esta cuenta dentro de respond.io.

1. Ve a Configuración del Espacio de trabajo > Canales.

2. Ubica el Canal de la Plataforma de WhatsApp Business (API) > haz clic en Administrar.

1. Configura el nombre del Canal, que se usa internamente para identificar la cuenta.

2. Haz clic en Guardar cambios para actualizar la Configuración de Canal.

Gestión del perfil de WhatsApp Business

Actualiza o revisa tu Perfil de WhatsApp Business directamente desde la plataforma respond.io.

1. Ve a Configuración del Espacio de trabajo > Canales.

2. Ubica el Canal de la Plataforma de WhatsApp Business (API) y haz clic en Administrar > Perfil.

1. Haz clic en Sincronizar perfil para obtener la información más reciente del Perfil de WhatsApp Business desde WhatsApp.

2. Edita los siguientes campos según sea necesario.

1. Revisa la información y haz clic en Guardar perfil.

Metadatos recibidos por el Canal

Diferentes canales proporcionan distintos conjuntos de metadatos de Contacto a la plataforma respond.io. Los siguientes datos de Contacto están disponibles desde este canal:

• Número de teléfono

• ID del número de teléfono

• Nombre del perfil

• ID de WhatsApp

• ID de usuario con alcance empresarial (BSUID)

• Usuario

Para los Contactos de WhatsApp que hayan adoptado un nombre de usuario, los campos BSUID y de nombre de usuario ahora están disponibles:
- En el array channel del objeto Channel Meta en los eventos de Webhook New Incoming Message y New Outgoing Message.
- El endpoint List Contact Channels ahora devuelve los campos BSUID y de nombre de usuario. Consulta la documentación de la API para ver las definiciones de campos actualizadas.
Esto se aplica a los nuevos Contactos creados después de abril de 2026.

Tipos de archivos admitidos

Los tipos de archivo no compatibles o los archivos que exceden el límite de tamaño se convierten automáticamente en un enlace URL en la plataforma respond.io. Los mensajes no compatibles se muestran como "Unsupported Message" o "Custom Payload" con el tipo (si está disponible). Haz clic en Mostrar más para ver la carga útil JSON de los mensajes "Custom Payload". Ejemplos de tipos de mensajes no compatibles con la Plataforma de WhatsApp Business (API): Reacciones, Mensajes eliminados, Encuestas, Mensajes efímeros

Confirma que el formato de archivo sea compatible antes de enviarlo. Los archivos que no se conviertan correctamente pueden fallar al enviarse incluso si están dentro del límite de tamaño. Obtén más información sobre los tipos de medios compatibles.

Formato de texto

Usa formato de texto o Markdown en tus mensajes. Aprende más sobre cómo formatear texto en WhatsApp.

Límites de velocidad

Un límite de velocidad es el número de llamadas a la API que una aplicación o un usuario puede realizar en un periodo de tiempo determinado. Obtén más información sobre los límites de velocidad de este canal.

Limitaciones del canal

Grupos de WhatsApp

Meta admite los mensajes de grupo en la Plataforma de WhatsApp Business (API), pero aún no están disponibles en respond.io. Vota por la Petición de Funcionalidad si esto es importante para tu caso de uso.

Tipos de número no admitidos

WhatsApp no permite números VoIP ni números gratuitos (toll-free). Esto incluye Números de Google Voice (VoIP).

WhatsApp Status

WhatsApp Status no es compatible con la Plataforma de WhatsApp Business (API). Publicar, enviar, recibir o gestionar WhatsApp Status no está disponible. Si te interesa esta función, vota por la Petición de Funcionalidad.

Meta Business Agent

Meta Business Agent es una capacidad separada de Meta — el propio Agente IA de Meta, configurado y administrado en las herramientas de Meta para un número de teléfono de WhatsApp específico. Conectar o gestionar un Meta Business Agent desde respond.io no es compatible actualmente. Vota por la Petición de Funcionalidad si esto es importante para tu caso de uso.

Mejores prácticas

Para mantener una configuración estable de la Plataforma de WhatsApp Business (API) y evitar bloqueos o interrupciones inesperadas, sigue estas mejores prácticas.

Evita la desactivación de WABA

Sigue estas mejores prácticas para evitar la desactivación de WABA.

Usa un Meta Business Manager (MBM) verificado y único

• Usa un MBM por empresa. Crear múltiples MBM con el mismo nombre comercial, dirección o sitio web puede ser señalado por Meta.

• Si un MBM anterior fue prohibido, evita usar los mismos datos comerciales para crear uno nuevo — Meta podría prohibirlo al instante.

• Verifica tu MBM enviando documentos oficiales de la empresa (p. ej., licencia comercial, sitio web coincidente).

• Controla el acceso con cuidado: otorga derechos de administrador solo a perfiles reales de Facebook con actividad consistente (publicaciones, amigos, etc.).

• Activa la Autenticación de Dos Factores (2FA) para todos los administradores.

Administra las Cuentas de WhatsApp Business (WABA) de manera responsable

• Si una WABA es prohibida, apela a través del Soporte de Meta. No crees una nueva WABA mientras la apelación esté pendiente — esto puede considerarse evasión de políticas.

• Usa nombres para mostrar claros y precisos. Por ejemplo, "Acme Co – California" es mejor que solo "Acme".

• No elimines ni vuelvas a crear números de teléfono con frecuencia (números “quemados”). Resuelve los problemas reportados a través de Meta.

Gestiona correctamente los usuarios de Facebook

• Los administradores deben usar cuentas auténticas de Facebook con historial real.

• Evita usar cuentas recién creadas o duplicadas solo para obtener acceso.

• Limita el acceso a los miembros esenciales del equipo y audita regularmente a los usuarios del MBM.

• Aplica la Autenticación de Dos Factores (2FA) para reducir el riesgo de accesos no autorizados.

Mantén tu negocio alineado entre plataformas

• Asegúrate de que tu nombre comercial, dirección, sitio web y otros datos coincidan en tu MBM, WABA y cuenta publicitaria.

• Esta alineación aumenta la confianza de Meta y mejora tus posibilidades de verificación.

Si tu WABA se desactiva

• No crees una nueva WABA.

• Presenta una apelación a través de Meta Business Support.

• Recopila y proporciona la documentación necesaria (p. ej., licencia comercial, comprobante de propiedad del dominio).

• Revisa y corrige cualquier violación de la Política de mensajería comercial de Meta.

Seguir estas mejores prácticas ayuda a mantener tu configuración de WhatsApp segura, estable y conforme a las políticas de Meta.

CRM o integraciones personalizadas

Si estás sincronizando Contactos desde respond.io a tu CRM o integraciones personalizadas, prepárate para:

• Agrega un campo BSUID dedicado a tu CRM. Almacena el BSUID junto a los identificadores existentes (número de teléfono o correo electrónico) para mapear las conversaciones correctamente y vincular el historial cuando no haya número de teléfono disponible.

• Crea lógica para manejar tanto números de teléfono como BSUIDs como identificadores. Tu sistema debería recurrir al BSUID cuando no haya un número de teléfono disponible para asociar los Contactos al registro correcto.

Libreta de contactos para WhatsApp

El WhatsApp Business Manager de Meta incluye una libreta de contactos para WhatsApp que almacena la información de contacto de los usuarios para mantener la continuidad de los hilos de mensajería. Está habilitada por defecto.

Si esta función está desactivada, respond.io no podrá emparejar a los Contactos que usan nombres de usuario de WhatsApp con sus registros de Contacto existentes cuando no haya habido interacción dentro de una ventana de 30 días. Esto resultará en la creación de entradas de Contacto duplicadas.

Para evitar entradas de Contacto duplicadas:

1. Ve a Meta Business Suite > Configuración del negocio > Información del negocio

2. Confirma que la libreta de contactos para WhatsApp esté activada.

Obtén más información sobre la libreta de contactos y la ventana de 30 días.

Configura un nombre de usuario comercial de WhatsApp

Meta está implementando gradualmente los nombres de usuario comerciales en regiones seleccionadas. Mientras tanto, puedes reservar un nombre de usuario ahora a través de Meta Business Suite — Meta lo guarda para tu número de WhatsApp, así ninguna otra empresa podrá reclamarlo. Tu nombre de usuario comercial reservado (aprobado por Meta) se activará una vez que la función esté oficialmente disponible en tu región.

El nombre de usuario comercial de WhatsApp es una función opcional que le da a tu empresa un identificador único — por ejemplo, @YourBusinessName. Tus Contactos pueden usarlo para encontrar y enviar mensajes a tu negocio sin necesitar tu número de teléfono.

El nombre de usuario comercial es diferente al nombre para mostrar:

• Tu nombre para mostrar no tiene que ser único.

• Tu nombre de usuario debe ser único por número de teléfono. Si tienes múltiples números de teléfono, cada uno necesita su propio nombre de usuario.

Cómo reservar un nombre de usuario:

1. Ve a Meta Business Suite > Configuración.

2. Haz clic en Cuentas de WhatsApp en el menú izquierdo.

3. Haz clic en el número de teléfono para el que quieres crear un nombre de usuario.

4. Haz clic en Números de teléfono, luego haz clic en el icono del lápiz.

5. Ve a Nombre de usuario, luego haz clic en Crear.

6. Introduce el nombre de usuario que deseas. También puedes elegir un nombre de usuario de Sugeridos.

7. Haz clic en Guardar.

Después de configurar el nombre de usuario comercial, tanto el nombre de usuario como el número de teléfono permanecerán visibles en el perfil de tu empresa.

Obtén más información sobre el nombre de usuario comercial para WhatsApp en la documentación de Meta.

¿Qué sigue?

• Prepárate para gestionar conversaciones entrantes en WhatsApp