Pular para o conteúdo principal

Portal Blip - Evolução na estrutura dos contatos

  • Atualizado

Índice

  1. Visão geral

  2. Novas visualização de contatos no Desk

  3. Novos filtros de contato

 

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

Visão geral

A evolução de plataforma contempla novas visualizações na estrutura dos contatos e também em seções relacionadas para visualizar todos os IDs listados abaixo:

  • BSUID

  • Username

  • Parent BSUID

  • WaId (número de telefone)

  • Novos filtros

  • Novas propriedades de contato

Os novos campos serão preenchidos apenas se informados pela Meta e serão disponibilizados para visualização e referências na plataforma. A edição manual desses campos NÃO é permitida.

Cabe ressaltar que a nova propriedade WaId não substitui o campo atual de telefone do contato, que segue existindo como campo editável e segue sendo referenciado pela variável contact.phonenumber. O campo não sofrerá nenhuma alteração ou atualização e seguirá mantendo o comportamento atual. 

 

No Desk (evolução)

Em breve!

A visualização do contato no Desk passará a incluir as informações de ID Blip e BSUID.

 

Filtros de contato no Portal Blip

Em breve!

Os filtros de busca do contato vão passar a permitir pesquisas por ID do WhatsApp, Username e BSUID, com as condições descritas a seguir.

Propriedade Condição de filtro
ID do WhatsApp (waId) Mesmas condições existentes para Phone Number
Username Igualdade
BSUID Igualdade

 

Via API Blip - GET /contacts

No ar!

O endpoint GET /contacts já está habilitado para retornar os novos IDs vinculados ao lançamento de usernames no WhatsApp. O objeto de requisição não sofre alterações. Os novos campos são somente leitura e são retornados apenas se estiverem preenchidos, desde que a Meta tenha enviado esses dados.

Exemplo: 

{
    "type": "application/vnd.lime.contact+json",
    "resource": {
        "name": "Nome do Contato",
        "lastMessageDate": "2026-04-30T01:25:20.859Z",
        "lastUpdateDate": "2026-06-11T19:16:35.548Z",
        "identity": "4911ae5f-ba7d-464c-bd86-c5ed60f1aa8d@wa.gw.msging.net",
        "phoneNumber": "51991234567",
        "extras": {
            "campo1": "valor",
            "campo2": "valor2"
        },
       "whatsAppBsuid": "BR.123456789",
        "whatsAppWaId": 51991234567,
        "whatsAppUserName": "meuContato",
        "whatsAppParentId": "BR.ENT.987654321"
    },
    "method": "get",
    "status": "success",
    "id": "27de23e8-2f6c-4ce3-9e34-0518c0ca2bd7",
    "from": "postmaster@crm.msging.net/#msging-application-crm-85f5c8bf8b-k5gmt",
    "to": "nomedo bot@msging.net/!msging-server-5f4c66d546-prf7k-s740zrjx",
    "metadata": {
        "traceparent": "00-ee3744050b891d7ee855eba6896276f6-4e4d38a6426bcb28-01",
        "#command.uri": "lime://nomedobot@msging.net/contacts/4911ae5f-ba7d-464c-bd86-c5ed60f1aa8d@wa.gw.msging.net"
    }

 

Filtros de contato via API

Agora você tem mais formas de encontrar um cliente. Na busca do CRM, você pode pesquisar diretamente pelo Identificador da Meta, pelo Nome de Usuário ou pelo ID do WhatsApp, sendo que apenas whatsAppBsuid poderá ser associado a outras propriedades do Contato na busca. Isso facilita a localização de contatos mesmo quando o número de telefone não está disponível.

Exemplo 1: Filtrar o contato por um BSUID

POST https://{{contract_id}}.http.msging.net/commands HTTP/1.1
Content-Type: application/json
Authorization: Key {YOUR_TOKEN}
{  
  "id": "{{$guid}}",
  "to": "postmaster@crm.msging.net",
  "method": "get",
  "uri": "/contacts?$take=100&$filter=(whatsAppBsuid%20eq%20'BR.123456789')"
}

Exemplo 2: Filtrar o contato por um username

POST https://{{contract_id}}.http.msging.net/commands HTTP/1.1
Content-Type: application/json
Authorization: Key {YOUR_TOKEN}
{  
  "id": "{{$guid}}",
  "to": "postmaster@crm.msging.net",
  "method": "get",
  "uri": "/contacts?$take=100&$filter=(whatsAppUserName%20eq%20'meuContato')"
}

Exemplo 3: Filtrar o contato por um waId

POST https://{{contract_id}}.http.msging.net/commands HTTP/1.1
Content-Type: application/json
Authorization: Key {YOUR_TOKEN}
{  
  "id": "{{$guid}}",
  "to": "postmaster@crm.msging.net",
  "method": "get",
  "uri": "/contacts?$take=20&$filter=(startswith(whatsAppWaId%2C'51991234'))%20and%20(source%20ne%20'blip.ai')%20and%20(lastmessagedate%20ge%20datetimeoffset'2026-01-02T03%3A00%3A00.000Z')%20%20and%20(lastmessagedate%20le%20datetimeoffset'2026-06-11T02%3A59%3A00.000Z')%20"
}


 

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