Saltar al contenido principal

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

  • Actualización

  1. Cómo enviar como plantilla de mensaje

    1. Creación de la plantilla

    2. Limitaciones importantes de Meta en el uso del componente

  2. Cómo enviar vía API

  3. Cómo usar dentro de Blip Studio/Builder

    1. Paso a paso en Builder

    2. Limitaciones de Meta para el Contenido Dinámico

 

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 una plantilla de mensaje y en mensajes interactivos, y también a realizar el envío a través de diferentes canales de nuestra API y directamente desde Blip Studio/Builder.
 

Cómo enviar como plantilla de mensaje

1. Creación de la plantilla

Para crear la plantilla, debes realizar una petición 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 de la plantilla de mensaje}}",
      "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 falla en el envío del componente:

  • Estructura fija: La petición DEBE tener exactamente la estructura JSON descrita arriba. Cualquier propiedad ausente o modificada fuera del estándar provocará una falla inmediata.

  • Componente de Botón: El objeto dentro de buttons debe contener obligatoriamente los valores "type":"REQUEST_CONTACT_INFO" y "text":"Share Contact Info". No cambies estos textos o tipos, ya que es una imposición de Meta para este recurso. La traducción del texto del botón la realiza automáticamente Meta.

  • Lo que puede personalizarse: 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 definirse como 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 hacer el envío directo a un contacto específico utilizando la API tradicional de envío de mensajes, formatea el payload según el 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 de la plantilla de mensaje}}",
            "components": []
        },
        "templateContent": {
            "name": "{{nombre de la plantilla de mensaje}}",
            "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 utilizando 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, agrega 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 única modificación libre permitida es en el campo "text" contenido en el objeto "body", que representa el texto descriptivo enviado al contacto.

 

¿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 😃

Artículos relacionados