Perguntas frequentes sobre suporte a nomes de usuário BSUID

Com a implementação pela Meta de nomes de usuário e IDs de usuário com escopo empresarial (BSUID) — em que o wa_id (número de telefone) de um cliente passa a ser condicional e o user_id (BSUID) está sempre presente —, este documento responde a perguntas frequentes sobre o plano de suporte do ChakraHQ para repasse de webhooks e a API de envio.

Repasse de webhook

1. O ChakraHQ encaminha user_id (BSUID) e username nos payloads de webhook de mensagens recebidas?

Sim, o Chakra já encaminha o BSUID (user_id) e o username quando esses campos estão disponíveis nos eventos originais da Meta para o seu cliente e WABA

2. O ChakraHQ encaminha user_id (BSUID) e username nos webhooks de status (enviada/entregue/lida)?

Sim, o Chakra já encaminha o BSUID (user_id) e o username quando esses campos estão disponíveis nos eventos originais da Meta para o seu cliente e WABA

3. user_id (BSUID) e username serão incluídos na resposta de list-chat-messages-for-phone-number ?

Não. Esta API foi criada para listar mensagens de conversa de um número de telefone

Envio por BSUID

4. O endpoint de envio/resposta aceita um BSUID como identificador do destinatário, em vez de exigir um número de telefone?

A API de repasse de mensagens oferece suporte a modificadores de destinatário para o envio de mensagens de sessão e de modelo

O envio de mensagem de modelo para número de telefone não oferece suporte a BSUID

5. Um comerciante pode responder a um contato que só tem nome de usuário e cujo número de telefone está oculto?

A caixa de entrada do Chakra Chat já oferece suporte a mensagens e conversas de contatos cujo telefone está oculto, mas o BSUID está disponível

Cronograma

6. Quando o suporte ao repasse de BSUID/nome de usuário por webhook estará disponível?

O Chakra Chat já oferece suporte aos novos campos, mas a Meta está expandindo gradualmente esse suporte pelo mundo. Portanto, se BSUID/nomes de usuário estiverem disponíveis para sua região/WABA, também estarão disponíveis para você pelo Chakra Chat.

7. Quando o suporte ao envio por BSUID estará disponível?

O Chakra Chat já oferece suporte ao envio de mensagens de sessão e de modelo usando o BSUID do destinatário. Consulte a seção "Envio por BSUID"

8. Considerando que a implementação da Meta na LATAM começa em setembro de 2026, o suporte do ChakraHQ estará pronto a tempo para essa região?

Sim

`user_id_update` Evento

9. O ChakraHQ encaminhará o webhook user_id_update da Meta (acionado quando a alteração do número de telefone de um usuário causa a regeneração do BSUID)?

Não. O evento user_id_update ainda não está disponível por meio de webhooks.

10. Qual será o formato/estrutura do payload do evento user_id_update encaminhado?

O evento user_id_update ainda não está disponível pelos webhooks do Chakra.

Nomenclatura dos campos

11. Quais nomes de campo o ChakraHQ usará para BSUID e nome de usuário nos payloads de repasse?

A estrutura do evento de webhook de repasse é idêntica à estrutura do evento de webhook bruto da Meta. Especificamente, os seguintes campos no evento de alteração

contacts
- user_id — Nova propriedade. Será definida como o BSUID do usuário.
messages
- from_user_id — Nova propriedade. Será definida como o BSUID do usuário.

Um exemplo da estrutura do evento pode ser encontrado aqui - https://apidocs.chakrahq.com/doc-919167#sample-inbound-text-message-event

12. O ChakraHQ usará os nomes de campo nativos da Meta (contacts[].user_id, messages[].from_user_id) ou campos personalizados/renomeados (como contact.userId)?

Sim, o evento de webhook de repasse usará os nomes de campo nativos da Meta

13. Onde podemos encontrar a documentação dos nomes de campo/esquema exatos para criar nosso analisador sem precisar adivinhar?