Envio de mensagens ativas com BSUID

Em breve!

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

Índice

1. O que NÃO muda
2. O que evolui
   1. Growth - Disparo individual
   2. Growth - Disparo em massa (CSV)
   3. Desk - Disparo de mensagens com BSUID
   4. Evolução dos payloads de API - Growth
   5. GET /accounts
3. Plugin de broadcast

O que não muda

• Disparos ativos via phone number continuam funcionando normalmente
• Templates de mensagens ativas continuam funcionando

• A opção de enviar mensagens ativas via API (Growth e Blip) permanece disponível

   

O que evolui

Portal Blip - Growth Individual

A interface de envio individual passará a oferecer a opção de envio por:

• Phone Number (modelo atual)
• BSUID (novo)

Portal Blip - Growth em massa (CSV)

A primeira coluna do arquivo CSV passará a aceitar os dois tipos de valores, inclusive intercalados na mesma base:

O nome da coluna não precisa ser alterado. Audiências mistas (PN e BSUID intercalados) são suportadas.

⚠️ Atenção! Caso PN e BSUID do mesmo usuário estejam presentes simultaneamente na base serão realizados 2 disparos para o mesmo usuário. Garantir a deduplicação é responsabilidade do remetente.

Desk - Disparo de mensagens por BSUID

O envio de mensagens ativas pelo Desk passará a permitir pesquisa por BSUID (filtro "igual a"). A exibição do contato durante o fluxo de envio também passará a apresentar username e BSUID.

Evolução dos payloads de API - Growth (Active Campaign)

Campo recipient

O campo recipient (identificador do contato sem o domínio) passará a aceitar PN (já suportado) e BSUID (nova opção).

Endpoints impactados: POST /campaign/full e GET /audiences/v2/{{id}}

POST /campaign/full - Sample payload

GET /audiences/v2/{{id}} - Sample payload

Em análise para evoluções futuras: suporte ao ID Blip (GUID) e Parent ID como recipient.

Campo recipientIdentity — /campaigns/summaries

Hoje retorna sempre {telefone}@wa.gw.msging.net. Com a evolução, poderá retornar PN ou GUID.

Campo validatedAccount — /audiences

Hoje retorna sempre {phonenumber}@wa.gw.msging.net. Com a evolução, poderá retornar PN ou GUID.

GET /accounts

O endpoint GET /accounts passará a aceitar BSUID como parâmetro de consulta (além de PN). O campo to do payload de disparo não muda, continuará sendo preenchido com a identidade obtida via GET /accounts.

ANTES - Sample payload

DEPOIS: PN como ID do contato - Sample payload

DEPOIS: GUID como ID do contato - Sample payload

Plugin de Broadcast

⚠️ O Plugin de Broadcast não acompanha a evolução do modelo de identidade do WhatsApp e não possui previsão de adaptação para suportar usernames, BSUIDs e a nova lógica de criação de contatos implementada no Blip.

Recomenda-se a migração gradual para a API de Growth do Blip. Manter o plugin pode resultar em criação de contatos duplicados, fragmentação de histórico e perda de continuidade em cenários com novos IDs.

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 😃