Envío de mensajes activos con BSUID

¡Próximamente!

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

Índice

1. Lo que NO cambia
2. Lo que evoluciona
   1. Growth - Envío individual
   2. Growth - Envío masivo (CSV)
   3. Desk - Envío de mensajes con BSUID
   4. Evolución de los payloads de API - Growth
   5. Consultando los resultados
   6. GET /accounts
3. Plugin de broadcast
4. FAQ - Preguntas frecuentes

Lo que no cambia

• Los envíos activos vía número telefónico continúan funcionando normalmente
• Las plantillas de mensajes activos continúan funcionando

• La opción de enviar mensajes activos vía API (Growth y Blip) permanece disponible

   

Lo que evoluciona

Portal Blip - Growth Individual

La interfaz de envío individual ofrecerá la opción de envío por:

• Número telefónico (modelo actual)
• BSUID (nuevo)

Portal Blip - Growth masivo (CSV)

¡En línea!

La primera columna del archivo CSV ahora acepta ambos tipos de valores, incluso intercalados en la misma base:

Ejemplo de archivo de envío

El nombre de la columna no necesita ser cambiado. Se soportan audiencias mixtas (PN y BSUID intercalados).

⚠️ ¡Atención! Si PN y BSUID del mismo usuario están presentes simultáneamente en la base se realizarán 2 envíos para el mismo usuario. Garantizar la deduplicación es responsabilidad del remitente.

Desk - Envío de mensajes por BSUID

El envío de mensajes activos desde Desk permitirá búsqueda por BSUID (filtro "igual a"). La visualización del contacto durante el flujo de envío también mostrará el nombre de usuario y BSUID.

Evolución de los payloads de API

Growth (Active Campaign)

Ahora la extensión Active Campaign de Blip procesa el BSUID (identificador del contacto sin el dominio) de la misma forma que procesa números telefónicos, aceptando ambas formas.

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

Escenario 1 — Campaña individual

POST /campaign/full - Mantiene el mismo payload. Solo hay que informar el identificador en el campo recipient al realizar la llamada 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": "Campaña individual vía BSUID",
            "campaignType": "Individual",
            "flowId": "{flowId}",
            "stateId": "{stateId}",
            "channelType": "WhatsApp"
        },
        "audience": {
            "recipient": "BR.1234567890123456",
            "messageParams": {
                "1": "Confirmación de su pedido"
            }
        },
        "message": {
            "messageTemplate": "confirmacion_pedido",
            "messageParams": ["1"],
            "channelType": "WhatsApp"
        }
    }
}

Escenario 2 — Campaña en lote (audiencia mixta)

POST /campaign/full - Mismo endpoint, pero para campañas en lote. Puedes combinar ambos identificadores en el mismo array de audiencia:

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

Escenario 3 — Inclusión de audiencia (audiencia mixta)

SET /audiences/v2/{{id de campaña creada}} -  Mantiene el mismo payload. Puedes combinar ambos identificadores en el mismo array de audiencia:

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"}
        ]
    }
}

Consulta de resultados

Al consultar el resumen o el informe de campaña, el campo recipientIdentity mostrará el BSUID para los contactos que no tengan número telefónico vinculado.

Consejos prácticos:

• Almacenamiento: Guarda el BSUID del contacto tan pronto como lo recibas en webhooks para garantizar la comunicación futura.

• Validación: Realiza pruebas con audiencias reducidas antes de envíos masivos usando BSUID.

• Integridad: Nunca edites manualmente un BSUID. El valor debe usarse exactamente como es retornado por la API de Meta.

Campo recipientIdentity — endpoint /campaigns/summaries

Actualmente siempre retorna {telefono}@wa.gw.msging.net. Con la evolución, retornará PN o GUID.

Campo validatedAccount — endpoint /audiences

Actualmente siempre retorna {phonenumber}@wa.gw.msging.net. Con la evolución, retornará PN o GUID.

En análisis para futuras evoluciones: soporte para ID Blip (GUID) y Parent ID como recipient.

GET /accounts

El endpoint GET /accounts ahora acepta BSUID como parámetro de consulta (además de PN). El campo to del payload de envío no cambia, seguirá siendo llenado con la identidad obtenida vía GET /accounts.

ANTES - Ejemplo de payload

DESPUÉS: PN como ID del contacto - Ejemplo de payload

DESPUÉS: GUID como ID del contacto - Ejemplo de payload

Plugin de Broadcast

⚠️ El Plugin de Broadcast no acompaña la evolución del modelo de identidad de WhatsApp y no tiene previsión de adaptación para soportar usernames, BSUIDs y la nueva lógica de creación de contactos implementada en Blip.

Se recomienda la migración gradual a la API de Growth de Blip. Mantener el plugin puede resultar en creación de contactos duplicados, fragmentación de historial y pérdida de continuidad en escenarios con nuevos IDs.

FAQ - Preguntas frecuentes

¿Puedo mezclar número y BSUID en la misma campaña?

Sí, Blip identifica el tipo de dato automáticamente en el campo recipient.

¿Qué pasa si uso un BSUID inválido?

El envío a ese destinatario fallará, pero no afectará el resto de la campaña.

¿Necesito habilitar algo en Blip?

No. El soporte para BSUID es nativo en las APIs de Campañas Activas y en el Builder.

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