Cómo crear y enviar componente de Solicitud de Contacto en WhatsApp en Blip – Blip | Blip Help

Blip te permite interactuar de forma más inteligente con tus clientes utilizando recursos nativos de WhatsApp. La funcionalidad de Solicitud de Contacto permite enviar un mensaje estructurado con un botón específico proporcionado por Meta para que el contacto comparta sus datos de contacto con tu contacto inteligente de forma sencilla, automática y segura.

En este artículo aprenderás a crear este componente en un modelo de mensaje y en mensajes interactivos, así como a enviarlo a través de diferentes canales de nuestra API y directamente desde Blip Studio/Builder.

Cómo enviar como modelo de mensaje

1. Creación del modelo

Para crear el modelo, debes realizar una solicitud HTTP utilizando el siguiente comando:

{
   "id":"{{$guid}}",
   "from":"{{$botIdentity}}",
   "method":"set",
   "type":"application/json",
   "to":"postmaster@wa.gw.msging.net",
   "uri":"/message-templates",
   "resource":{
      "name":"{{nombre del message template}}",
      "components":[
         {
            "type":"BUTTONS",
            "buttons":[
               {
                  "type":"REQUEST_CONTACT_INFO",
                  "text":"Share Contact Info"
               }
            ]
         },
         {
            "type":"BODY",
            "text":"{{Texto del cuerpo del mensaje}}"
         }
      ],
      "language":"pt_BR",
      "category":"{{UTILITY o MARKETING}}"
   }
}

2. Limitaciones importantes de Meta en el uso del componente

Al tratarse de una funcionalidad nativa del ecosistema de Meta, existen reglas específicas que deben seguirse rigurosamente para evitar la desaprobación o fallo en el envío del componente:

Estructura fija: La solicitud DEBE tener exactamente la estructura JSON descrita arriba. Cualquier propiedad ausente o modificada fuera del estándar causará fallo inmediato.
Componente de Botón: El objeto dentro de buttons debe contener obligatoriamente los valores "type":"REQUEST_CONTACT_INFO" y "text":"Share Contact Info". No modifiques estos textos o tipos, ya que son una imposición de Meta para este recurso. La traducción del texto del botón la realiza automáticamente Meta.
Lo que se puede personalizar: la única flexibilidad permitida en la creación es el campo "text" dentro del componente "BODY" (donde va el mensaje principal que el usuario leerá), la definición del idioma ("language") y la categoría ("category"), que puede ser UTILITY o MARKETING (y puede ser revisada posteriormente por Meta).

Uso de Variables: Puedes utilizar variables dinámicas (como {{1}}, {{2}}) normalmente dentro del texto del cuerpo (BODY). Para entender más sobre la aprobación y buenas prácticas de variables, accede a nuestra Guía de creación y aprobación de Message Template en WhatsApp.

Cómo enviar vía API

Si prefieres enviar directamente a un contacto específico utilizando la API tradicional de envío de mensajes, formatea el payload conforme al modelo estructurado a continuación:

{
   "id":"{{$guid}}",
   "to":"{{$userIdentity}}@wa.gw.msging.net",
   "type":"application/json",
   "content": {
        "type": "template",
        "template": {
            "language": {
                "policy": "deterministic",
                "code": "pt_BR"
            },
            "name": "{{nombre del message template}}",
            "components": []
        },
        "templateContent": {
            "name": "{{nombre del message template}}",
            "language": "pt_BR",
            "category": "{{UTILITY o MARKETING}}"
        }
    }
}

Cómo usar dentro de Blip Studio/Builder

También es posible incluir este componente de solicitud en una conversación dentro del flujo de tu contacto inteligente usando Blip Studio/Builder. Para ello es necesario utilizar el bloque de Contenido Dinámico.

Si aún no estás familiarizado con este tipo de componente, recomendamos la lectura previa del artículo Cómo usar contenido dinámico.

Paso a paso en Builder

En el bloque deseado de tu flujo, añade un nuevo componente de contenido del tipo Contenido Dinámico.

Define el campo Tipo como application/json.
En el campo Valor del contenido, completa con el siguiente JSON:

{
        "recipient_type":"individual",
        "type":"interactive",
        "interactive": {
            "type": "request_contact_info",
            "body": {
                "text": "Por favor, comparte tu contacto para que podamos continuar nuestra conversación."
            },
            "action": {
                "name": "request_contact_info"
            }
        }
}

Limitaciones de Meta para el Contenido Dinámico

Al igual que en la API, existen propiedades inmutables según las especificaciones de Meta:

El valor de "type" dentro de "interactive" debe ser estrictamente "request_contact_info".
El valor de "name" dentro de "action" debe ser obligatoriamente "request_contact_info".
La modificación libre está permitida solo en el campo "text" contenido en el objeto "body", que representa el texto descriptivo enviado al contacto.

Cómo verificar el origen del contacto compartido en WhatsApp

⚠️ Los comportamientos abajo representan el diseño actual de la funcionalidad y pueden evolucionar hasta su disponibilidad final.

Cuando un usuario comparte un contacto a través del componente de WhatsApp proporcionado por Meta, se añaden metadatos específicos al mensaje que permiten identificar el origen y tipo de compartición. Estos metadatos son esenciales para diferenciar cuando el usuario comparte su propia información de contacto o la de otra persona.

Metadatos Disponibles

1. `#wa.sharedWaId`

Este metadato indica que el mensaje contiene información de identificación del número telefónico. Aparece como una propiedad nueva que confirma la presencia de datos de WaId en el contexto de los mensajes. Se omitirá si el usuario aún no ha compartido su contacto.

Está disponible en todos los mensajes en los que WhatsApp proporciona un WhatsApp ID (WaId).

2. `#wa.contactOrigin`

Este metadato identifica el origen del contacto compartido, permitiendo distinguir cuando el usuario comparte su propia información o datos de terceros.

Valores posibles:

- `contact_request` - El usuario compartió su propia información de contacto (a través de un botón REQUEST_CONTACT_INFO o similar)

- `other` - El usuario comparte el contacto de otra forma que no sea vía botón de llamada a la acción (CTA), por ejemplo, desde la agenda de contactos, pudiendo ser la suya propia o de otra persona.

Nota: Este metadato se muestra solo en mensajes del tipo contactos compartidos.

Identificación del contacto compartido

Cuando un mensaje de contacto compartido contiene tanto `#wa.sharedWaId` como `#wa.contactOrigin` con valor "contact_request", puedes confirmar que el contacto compartido es del propio usuario que está enviando el mensaje, ya que aunque se comparta mediante el CTA por el cual el usuario comparte su información de contacto, tiene la opción de omitir el número telefónico. De esta forma, solo es posible confirmar que el contacto compartido es el mismo del usuario con ambas informaciones.

Visualización del componente de Solicitud de Contacto

Aquí presentamos algunas imágenes para ejemplificar cómo se mostrará el componente de solicitud en el hilo de la conversación:

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