URLs personalizadas en botones de campañas - Guía de Usuario

¿Qué es esta Funcionalidad?

• Enlaces de seguimiento de pedidos con IDs únicos de orden

• Enlaces de soporte al cliente con parámetros específicos del cliente

• Gestión de citas con identificadores únicos de cita

• Páginas de productos personalizadas con seguimiento específico del usuario

¿Dónde Puedo Acceder a Esta Funcionalidad?

POST /api/external/v2/whatsapp_campaigns/

¿Cómo Usarla?

Requisitos Previos

1. Tu plantilla de WhatsApp incluye componentes de botón con marcadores de posición numéricos usando la sintaxis {{1}}, {{2}}, etc.

2. Tienes acceso al endpoint de la API externa v2 para campañas de WhatsApp

3. Tu plantilla de WhatsApp está aprobada por Meta/WhatsApp con los parámetros de botón

Paso 1: Prepara tu Plantilla de WhatsApp

{
   "buttons":[
      {
         "type":"URL",
         "text":"Rastrear Pedido",
         "url":"https://tusitio.com/pedidos/{{1}}"
      },
      {
         "type":"URL",
         "text":"Contactar Soporte",
         "url":"https://tusitio.com/soporte?cliente={{1}}"
      }
   ]
}

Paso 2: Prepara los Datos de tu Campaña

button_[nombre_descriptivo]

Paso 3: Crea tu Campaña

{
   "account_uid":"tu_account_uid",
   "visual_name":"Campaña de Rastreo de Pedidos",
   "key":"tu_clave_de_plantilla",
   "headers":[
      "user_id",
      "image_url",
      "param_1",
      "param_2",
      "param_3",
      "button_orderid",
      "button_customerid",
      "campo_metadata"
   ],
   "records":[
      [
         "56912345678",
         "https://example.com/image.jpg",
         "Juan Pérez",
         "Pedido #12345",
         "Enviado",
         "ORD12345",
         "CUST001",
         "metadata_extra"
      ],
      [
         "56987654321",
         "https://example.com/image.jpg",
         "María García",
         "Pedido #67890",
         "En proceso",
         "ORD67890",
         "CUST002",
         "metadata_extra"
      ]
   ],
   "bot_id":null,
   "mins_to_close":10,
   "mins_to_retry":5,
   "allow_survey":true,
   "allow_duplicate_users":false
}

Reglas Importantes

1. Convención de Nomenclatura de Columnas

• Las columnas de parámetros de botón deben empezar con button_

• La parte después de button_ es solo descriptiva (puede ser cualquier nombre que te ayude a identificar el propósito)

• Ejemplos: button_orderid, button_numero_pedido, button_tracking

2. El Orden de las Columnas es Crítico

• El orden de las columnas button_* en tus headers determina a qué botón va cada valor

• Primera columna button_* → Primer botón (parámetro {{1}})

• Segunda columna button_* → Segundo botón (parámetro {{1}})

• Tercera columna button_* → Tercer botón (parámetro {{1}})

• Los nombres son solo descriptivos; el orden es lo que importa

3. Los Parámetros de Botón No Pueden Estar Vacíos

• Cada valor de parámetro de botón debe contener una cadena no vacía

• Si un parámetro de botón está vacío, la validación de la campaña fallará con un error EMPTY_PARAMETER

4. Parámetros de Botón vs Parámetros Regulares

• Los parámetros de botón son separados de los parámetros regulares del mensaje (param_1, param_2, etc.)

• Las columnas de parámetros de botón no se incluyen en metadata

• Se usan específicamente para personalización de URLs de botones

5. Funcionalidad Opcional

• Si tu plantilla no tiene botones, no necesitas incluir columnas button_*

• Las campañas existentes sin parámetros de botón continuarán funcionando normalmente

Ejemplo Completo

Tu Plantilla de WhatsApp:

Mensaje: Hola {{1}}, tu pedido {{2}} está {{3}}! Revisa los detalles abajo.

Botón 1: "Rastrear Pedido" → https://tienda.example.com/rastreo/{{1}}
Botón 2: "¿Necesitas Ayuda?" → https://tienda.example.com/soporte?cliente={{1}}

Tu Solicitud API:

{
   "account_uid":"abc123",
   "visual_name":"Actualizaciones de Pedidos Septiembre",
   "key":"plantilla_actualizacion_pedido",
   "headers":[
      "user_id",
      "image_url",
      "param_1",
      "param_2",
      "param_3",
      "button_orderid",
      "button_customerid",
      "id_pedido_interno"
   ],
   "records":[
      [
         "56912345678",
         "https://cdn.example.com/paquete.jpg",
         "María",
         "Audífonos Premium",
         "listo para recoger",
         "TRK789456",
         "CUS987654",
         "pedido_interno_123"
      ],
      [
         "56987654321",
         "https://cdn.example.com/paquete.jpg",
         "Carlos",
         "Mouse Inalámbrico",
         "en camino",
         "TRK123789",
         "CUS123456",
         "pedido_interno_456"
      ]
   ],
   "bot_id":null,
   "mins_to_close":30,
   "mins_to_retry":10,
   "allow_survey":true,
   "allow_duplicate_users":false
}

Lo que Recibe Cada Destinatario:

Hola María, tu pedido Audífonos Premium está listo para recoger! Revisa los detalles abajo.

[Rastrear Pedido] → https://tienda.example.com/rastreo/TRK789456
[¿Necesitas Ayuda?] → https://tienda.example.com/soporte?cliente=CUS987654

Hola Carlos, tu pedido Mouse Inalámbrico está en camino! Revisa los detalles abajo.

[Rastrear Pedido] → https://tienda.example.com/rastreo/TRK123789
[¿Necesitas Ayuda?] → https://tienda.example.com/soporte?cliente=CUS123456

Mejores Prácticas

1. Prueba con Campañas Pequeñas Primero: Crea una campaña de prueba con 1-2 destinatarios antes de enviar a toda tu audiencia

2. Usa Nombres Descriptivos de Parámetros: Usa nombres claros como button_orderid, button_numero_rastreo, button_id_cita

3. Valida tus Datos: Asegúrate de que todos los valores de parámetros de botón estén presentes y correctamente formateados antes de enviar

4. Verifica el Orden: Revisa dos veces que el orden de tus columnas button_* coincida con el orden de los botones en tu plantilla

5. Mantén las URLs Cortas: Aunque puedes personalizar URLs, mantenlas razonablemente cortas para una mejor experiencia de usuario