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. Consultando os resultados
   6. GET /accounts
3. Plugin de broadcast
4. FAQ - Perguntas frequentes

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)

No ar!

A primeira coluna do arquivo CSV agora aceita os dois tipos de valores, inclusive intercalados na mesma base:

Exemplo de arquivo de envio

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)

Agora a extensão Active Campaign do Blip processa o BSUID (identificador do contato sem o domínio) da mesma forma que processa números de telefone, passando a aceitar as duas formas.

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

Cenário 1 — Campanha individual

POST /campaign/full - Mantém o mesmo payload.Basta informar o identificador no campo recipient ao realizar a chamada de API:

POST https://{{contract_id}}.http.msging.net/commands HTTP/1.1
Content-Type: application/json
Authorization: Key {YOUR_TOKEN}

{
    "id": "%commandId",
    "to": "postmaster@activecampaign.msging.net",
    "method": "set",
    "uri": "/campaign/full",
    "type": "application/vnd.iris.activecampaign.full-campaign+json",
    "resource": {
        "campaign": {
            "name": "Campanha individual via BSUID",
            "campaignType": "Individual",
            "flowId": "{flowId}",
            "stateId": "{stateId}",
            "channelType": "WhatsApp"
        },
        "audience": {
            "recipient": "BR.1234567890123456",
            "messageParams": {
                "1": "Confirmação do seu pedido"
            }
        },
        "message": {
            "messageTemplate": "confirmacao_pedido",
            "messageParams": ["1"],
            "channelType": "WhatsApp"
        }
    }
}

Cenário 2 — Campanha em lote (audiência mista)

POST /campaign/full - Mesmo endpoint, porém para campanhas em lote. Você pode combinar ambos os identificadores no mesmo array de audiência:

"audiences": [
    {
        "recipient": "BR.1234567890123456",
        "messageParams": {
            "nome": "Ana",
            "numero_pedido": "1029"
        }
    },
    {
        "recipient": "+55319XXXXXXXX",
        "messageParams": {
            "nome": "Carlos",
            "numero_pedido": "1030"
        }
    }
]

Cenário 3 — Inclusão de audiência (audiência mista)

SET /audiences/v2/{{id da campanha criada} -  Mantém o mesmo payload. Pode combinar ambos os identificadores no mesmo array de audiência:

POST https://{{contract_id}}.http.msging.net/commands HTTP/1.1
Content-Type: application/json
Authorization: Key {YOUR_TOKEN}

{
    "id": "{{$guid}}",
    "to": "postmaster@activecampaign.msging.net",
    "method": "set",
    "uri": "/audiences/v2/{{resource.id}}",
    "type": "application/vnd.lime.collection+json",
    "resource": {
        "itemType": "application/vnd.iris.activecampaign.audience+json",
        "items": [
            {"recipient": "+5520900000001"},
            {"recipient": "BR.1234567890123456"}
        ]
    }
}

Consultando os resultados

Ao consultar o resumo ou o relatório de campanha, o campo recipientIdentity exibirá o BSUID para os contatos que não possuem número de telefone vinculado.

Dicas práticas:

• Armazenamento: Salve o BSUID do contato assim que recebê-lo em webhooks para garantir a comunicação futura.

• Validação: Realize testes com audiências reduzidas antes de disparos massivos usando BSUID.

• Integridade: Nunca edite manualmente um BSUID. O valor deve ser utilizado exatamente como retornado pela API da Meta.

Campo recipientIdentity —  endpoint /campaigns/summaries

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

Campo validatedAccount — endpoint /audiences

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

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

GET /accounts

O endpoint GET /accounts agora a aceita 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.

FAQ - Perguntas frequentes

Posso misturar número e BSUID na mesma campanha?

Sim, o Blip identifica o tipo de dado automaticamente no campo recipient.

O que acontece se eu usar um BSUID inválido?

O envio para esse destinatário falhará, mas não afetará o restante da campanha.

Preciso habilitar algo no Blip?

Não. O suporte ao BSUID é nativo nas APIs de Campanhas Ativas e no Builder.

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 😃