Síntoma / Necesidad

Necesitas que tu flujo de chatbot envíe de forma automática una tarjeta de contacto completa a un cliente a través de WhatsApp. Esta tarjeta debe contener información detallada como nombre, teléfono, correo electrónico, dirección, etc. 

Contexto / Escenarios

Durante una interacción automatizada, a menudo es necesario proporcionar al cliente los datos de contacto de una persona o área específica para continuar una gestión. Enviar estos datos como texto simple puede ser propenso a errores y poco práctico para el cliente.

La solución ideal es enviar una tarjeta de contacto (.vcf), que el cliente puede guardar directamente en la agenda de su teléfono con un solo clic. Esto es perfecto para escenarios como:

• Transferencia a Ventas: Al final de una calificación de lead, el chatbot puede enviar el contacto del asesor de ventas asignado.
• Soporte Técnico: Si un problema requiere atención especializada, el flujo puede enviar el contacto del área de soporte de Nivel 2.
• Información de Sucursales: Un bot informativo puede enviar la tarjeta de contacto de la sucursal más cercana, incluyendo dirección, teléfono y horarios.

Respuesta (Solución / Recomendación)

Puedes enviar una tarjeta de contacto completa utilizando la plantilla "send contact" dentro del componente "Responder chat" en wolkvox Studio.

Importante: Esta funcionalidad es exclusiva para conectores de WhatsApp de tipo "API Cloud".

Pasos de Configuración

1. Ingresa al Componente: Dentro de tu flujo de chatbot, agrega un componente "Responder chat".
2. Ve a la Pestaña "Avanzado": En el panel de configuración del componente, selecciona la pestaña "Avanzado".
3. Selecciona la Plantilla: En el menú desplegable, elige la opción "Send contact (api cloud)".
4. Carga la Estructura: Haz clic en el botón "Cargar plantilla". Esto poblará el campo de texto con una estructura JSON que contiene todos los campos disponibles para la tarjeta de contacto.

Estructura de la Plantilla de Contacto

Una vez cargada, verás una estructura JSON que puedes modificar. Puedes rellenar los campos con información estática (escribiendo directamente) o con variables del flujo (ej. $nombre_asesor, $telefono_soporte).

A continuación, se explica cada campo principal:

• name (Nombre): Define el nombre completo del contacto.
  • formatted_name: El nombre completo tal como aparecerá.
  • first_name: Primer nombre.
  • last_name: Apellido.
• phones (Teléfonos): Lista de números de teléfono.
  • phone: El número de teléfono (incluyendo código de país).
  • type: Tipo de teléfono, como "WORK" (trabajo) o "HOME" (hogar).
• emails (Correos Electrónicos): Lista de correos.
  • email: La dirección de correo.
  • type: "WORK" o "HOME".
• addresses (Direcciones): Lista de direcciones físicas.
  • Incluye subcampos como street (calle), city (ciudad), state (estado), zip (código postal) y country (país).
  • type: "WORK" o "HOME".
• org (Organización): Detalles de la empresa del contacto.
  • company: Nombre de la empresa.
  • department: Departamento.
  • title: Cargo o título.
• urls (Sitios Web): Lista de URLs asociadas.
  • url: La dirección del sitio web.
  • type: "WORK" o "HOME".
• birthday (Fecha de nacimiento): Fecha en formato AAAA-MM-DD.

⚠️ Nota Crítica: El campo addresses (direcciones) es esencial para el correcto funcionamiento de la plantilla, incluso si no vas a enviar una dirección. No elimines este campo de la estructura JSON. Si no necesitas especificar una dirección, simplemente deja los valores de sus subcampos vacíos (ej. "street": ""), pero mantén la estructura intacta.

Ejemplo del JSON completado

[
    {
        "addresses": [
            {
                "street": "Cra 30 # 4A-45 Of. 205 Ed. FOREVER W&L",
                "city": "Medellín",
                "state": "Antioquia",
                "zip": "050021",
                "country": "Colombia",
                "country_code": "CO",
                "type": "WORK"
            }
        ],
        "birthday": "",
        "emails": [
            {
                "email": "soporte@miempresa.com",
                "type": "WORK"
            }
        ],
        "name": {
            "formatted_name": "Soporte Técnico wolkvox",
            "first_name": "Soporte Técnico",
            "last_name": "wolkvox",
            "middle_name": "",
            "suffix": "",
            "prefix": ""
        },
        "org": {
            "company": "wolkvox",
            "department": "Soporte Técnico",
            "title": "Equipo de Asistencia"
        },
        "phones": [
            {
                "phone": "+573000000000",
                "wa_id": "",
                "type": "WORK"
            }
        ],
        "urls": [
            {
                "url": "https://www.wolkvox.com",
                "type": "WORK"
            }
        ]
    }
]