Saltar al contenido principal

Portal Blip - Evolución en la estructura de los contactos

  • Actualización

Índice

  1. Visión general

  2. Nueva visualización de contactos en el Desk

  3. Nuevos filtros de contacto

 

⚠️ Los comportamientos a continuación representan el diseño actual de la funcionalidad y pueden evolucionar hasta la disponibilidad final. 
 

Visión general

La evolución de la plataforma contempla nuevas visualizaciones en la estructura de los contactos y también en secciones relacionadas para visualizar todos los IDs listados a continuación:

  • BSUID

  • Nombre de usuario (Username)

  • BSUID padre (Parent BSUID)

  • WaId (número de teléfono)

  • Nuevos filtros

  • Nuevas propiedades de contacto

Los nuevos campos se llenarán solo si son proporcionados por Meta y estarán disponibles para visualización y referencias en la plataforma. La edición manual de estos campos NO está permitida.

Cabe destacar que la nueva propiedad WaId no reemplaza el campo actual de teléfono del contacto, que continúa existiendo como campo editable y sigue siendo referenciado por la variable contact.phonenumber. El campo no sufrirá ninguna modificación ni actualización y mantendrá su comportamiento actual. 

 

En el Desk (evolución)

¡Próximamente!

La visualización del contacto en el Desk incluirá la información de ID Blip y BSUID.

 

Filtros de contacto en el Portal Blip

¡Próximamente!

Los filtros de búsqueda del contacto permitirán buscar por ID de WhatsApp, Nombre de usuario (Username) y BSUID, con las condiciones descritas a continuación.

Propiedad Condición de filtro
ID de WhatsApp (waId) Mismas condiciones existentes para Número de teléfono (Phone Number)
Nombre de usuario (Username) Igualdad
BSUID Igualdad

 

Vía API Blip - GET /contacts

¡En línea!

El endpoint GET /contacts ya está habilitado para devolver los nuevos IDs vinculados al lanzamiento de nombres de usuario en WhatsApp. El objeto de solicitud no sufre cambios. Los nuevos campos son sólo de lectura y se retornan únicamente si están llenos, siempre que Meta haya enviado esos datos.

Ejemplo: 

{
    "type": "application/vnd.lime.contact+json",
    "resource": {
        "name": "Nombre del Contacto",
        "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": "miContacto",
        "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": "nomedobot@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 contacto vía API

Ahora tienes más formas de encontrar a un cliente. En la búsqueda del CRM, puedes buscar directamente por el Identificador de Meta, por el Nombre de usuario o por el ID de WhatsApp, siendo que sólo whatsAppBsuid podrá asociarse a otras propiedades del Contacto en la búsqueda. Esto facilita la localización de contactos incluso cuando el número de teléfono no está disponible.

Ejemplo 1: Filtrar el contacto por un 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')"
}

Ejemplo 2: Filtrar el contacto por un nombre de usuario

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'miContacto')"
}

Ejemplo 3: Filtrar el contacto por un 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"
}


 

¿Necesitas más ayuda? Explora nuestros contenidos en Blip Academy o Blip Community, mira tutoriales en nuestro canal de YouTube o resuelve tus dudas en nuestro canal de atención 😃

Artículos relacionados