Pular para o conteúdo principal

Novas variáveis do Builder/Studio

  • Atualizado

Em breve!

⚠️ Os comportamentos abaixo representam o desenho atual da funcionalidade e podem evoluir até a disponibilização final. 
 

Índice

  1. Visão geral

  2. Novas variáveis previstas no Blip

  3. Variáveis com comportamento alterado

  4. Quando usar cada variável

  5. Boas práticas

 

Visão geral

As variáveis de contato do Studio continuarão existindo e mantendo seu propósito. Com a evolução do modelo de identidade, entretanto, novas variáveis serão adicionadas para representar os novos IDs do ecossistema WhatsApp e algumas variáveis já existentes terão seu formato atualizado.

 

Novas variáveis previstas no Blip

Variável O que retorna Quando usar
contact.whatsAppBsuid BSUID do usuário Identificação contextual do usuário com a empresa em questão
contact.whatsAppParentId Parent BSUID (se aplicável) Consolidação e/ou referênica do mesmo usuário cross-BMs
contact.whatsAppUserName Username do usuário (se aplicável) Exibição e/ou referência visual
contact.waId ID numérico do WhatsApp, corresponde ao phone number quando disponível (não editável) Para referenciar o PN do usuário (se disponível)

 

 

Variáveis com comportamento alterado

As variáveis contact.identity, tunnel.originator e tunnel.identity continuarão existindo, mas poderão retornar GUID no lugar de PN quando o PN não estiver disponível:

Cenário Valor retornado nas variáveis de ID do contato
Contato que já existe com PN como ID principal 5531999999999@wa.gw.msging.net
Contato novo com PN compartilhado 5531999999999@wa.gw.msging.net
Contato novo sem PN compartilhado (username adotado) e4b11bdd-a9bf-46ad-a9b0-34116dece5fe@wa.gw.msging.net

⚠️ Integrações, regex ou regras que assumam que esses campos sempre conterão um telefone podem precisar de adaptação. Recomenda-se iniciar desde já a remoção de qualquer dependência de parsing ou split de phone number a partir dessas variáveis.

 

Quando usar cada variável

Necessidade Variável recomendada Observação
Identificar o contato na Blip contact.identity (como string genérica) Pode conter PN ou GUID
Obter o telefone quando disponível contact.waId Pode estar vazio quando o usuário tiver username adotado
Relacionamento usuário ↔ empresa contact.whatsAppBsuid Único ID disponível em 100% das interações
Consolidar identidade entre BMs (quando aprovado pela Meta) contact.whatsAppParentId Disponível em casos específicos (elegibilidade e check Meta)
Exibir o nome público do usuário contact.whatsAppUserName Só estará preenchido para usuários que adotarem username

 

Boas práticas

Sugerimos, após a leitura desse artigo, avaliar preventivamente e corretivamente (quando aplicável) seus fluxos no Blip e integrados ao Blip para consumir as variáveis disponíveis da forma mais assertiva possível para sua operação.

 

Precisa de mais ajuda? Explore nossos conteúdos na Blip Academy ou Blip Community, assista a tutoriais no nosso canal do YouTube ou tire suas dúvidas em nosso canal de atendimento 😃
 

Artigos relacionados