Preguntas frecuentes sobre la compatibilidad con nombres de usuario de BSUID

Compatibilidad de Chakra Chat con la implementación de BSUID/nombres de usuario de Meta

Mientras Meta implementa los nombres de usuario y los ID de usuario con alcance empresarial (BSUID), donde el wa_id (número de teléfono) de un cliente pasa a ser condicional y el user_id (BSUID) siempre está presente, este documento responde preguntas frecuentes sobre el plan de compatibilidad de ChakraHQ con la transferencia directa de webhooks y la API de envío.

Transferencia directa de webhooks

1. ¿ChakraHQ incluye user_id (BSUID) y username en las cargas de webhooks de los mensajes entrantes?

Sí, Chakra ya reenvía BSUID (user_id) y el nombre de usuario cuando los campos están disponibles en los eventos originales de Meta para tu cliente y WABA

2. ¿ChakraHQ incluye user_id (BSUID) y username en los webhooks de estado (enviado/entregado/leído)?

Sí, Chakra ya reenvía BSUID (user_id) y el nombre de usuario cuando los campos están disponibles en los eventos originales de Meta para tu cliente y WABA

3. ¿Se incluirán user_id (BSUID) y username en la respuesta de list-chat-messages-for-phone-number ?

No. Esta API está diseñada para listar los mensajes del chat asociados a un número de teléfono

Enviar mediante BSUID

4. ¿El endpoint de envío/respuesta acepta un BSUID como identificador del destinatario, en lugar de exigir un número de teléfono?

La API de mensajes de transferencia directa admite modificadores del destinatario para enviar mensajes de sesión y de plantilla

El envío de mensajes de plantilla a un número de teléfono no admite BSUID

5. ¿Puede un comerciante responder a un contacto que solo tiene nombre de usuario y cuyo número de teléfono está oculto?

La bandeja de entrada de Chakra Chat ya admite mensajes y chats de contactos cuyo número de teléfono está oculto, pero tienen un BSUID disponible

Disponibilidad

6. ¿Cuándo estará disponible la compatibilidad con BSUID/nombres de usuario en la transferencia directa de webhooks?

Chakra Chat ya admite los nuevos campos, pero Meta está implementando gradualmente la compatibilidad en todo el mundo. Por lo tanto, si BSUID/nombres de usuario están disponibles en tu región o WABA, también estarán disponibles para ti a través de Chakra Chat.

7. ¿Cuándo estará disponible la compatibilidad para enviar mediante BSUID?

Chakra Chat ya admite el envío de mensajes de sesión y de plantilla mediante un BSUID como destinatario. Consulta la sección «Enviar mediante BSUID»

8. Dado que la implementación de Meta en LATAM comienza en septiembre de 2026, ¿estará lista la compatibilidad de ChakraHQ a tiempo para esa región?

Sí

`user_id_update` Evento

9. ¿ChakraHQ reenviará el webhook user_id_update de Meta (que se activa cuando el cambio del número de teléfono de un usuario hace que se regenere el BSUID)?

No. El evento user_id_update aún no está disponible mediante webhooks.

10. ¿Qué aspecto tendrá la forma/estructura de la carga del evento user_id_update reenviado?

El evento user_id_update aún no está disponible mediante los webhooks de Chakra.

Nombres de campos

11. ¿Qué nombres de campo usará ChakraHQ para BSUID y nombre de usuario en las cargas de transferencia directa?

La estructura de los eventos de webhook de transferencia directa es idéntica a la estructura de los eventos de webhook sin procesar de Meta. Específicamente, los siguientes campos del evento de cambio

contacts
- user_id — Nueva propiedad. Se establecerá con el BSUID del usuario.
messages
- from_user_id — Nueva propiedad. Se establecerá con el BSUID del usuario.

Aquí puedes encontrar un ejemplo de la estructura del evento: https://apidocs.chakrahq.com/doc-919167#sample-inbound-text-message-event

12. ¿ChakraHQ usará los nombres de campo nativos de Meta (contacts[].user_id, messages[].from_user_id) o campos personalizados/con nombres distintos (como contact.userId)?

Sí, el evento de webhook de transferencia directa usará los nombres de campo nativos de Meta

13. ¿Dónde podemos encontrar la documentación de los nombres exactos de los campos y del esquema para crear nuestro analizador sin tener que adivinarlos?