Elementos de la plantilla
{receptor phone}: el número de teléfono al que se enviará el mensaje. Este número debe incluir el prefijo internacional del país.
{API key}: la clave API del trabajador de IA. Esta clave establece automáticamente el número de teléfono desde el cual se enviará el mensaje como el trabajador, si el trabajador está conectado a un canal de WhatsApp.
{WPP API provider}: actualmente todas las nuevas implementaciones deben usar “wa-cloud”, lo que significa que el cliente usa directamente la API de WhatsApp a través de META, y no mediante un BSP (Business Solution Provider) como, por ejemplo, Gupshup. Es posible que veas muchas implementaciones con “wa-gupshup”.
{pipeline ID}: es el ID del flujo (pipeline), que puedes obtener desde la URL al seleccionar un flujo en la sección “Pipelines”.
Por ejemplo, en la URL:
https://app.getdarwin.ai/agent/1805/pipelines/2064
el número 2064 es el ID del flujo (pipeline ID) y 1805 es el ID del agente (agent ID).
{template id}: el ID de la plantilla de mensaje. Un mensaje enviado por API como mensaje saliente (outbound) debe estar basado en una plantilla, es decir, debe crearse una plantilla y Meta debe aprobarla.
{param x value}: son los valores de los parámetros de la plantilla si esta los tiene (campos variables como, por ejemplo, nombre, fecha u hora).
El objeto “Source” (Origen)
{datax} y {datax value}
El objeto “source” no es obligatorio. Solo es necesario si queremos que el mensaje lleve información “oculta”. Se llama “oculta” porque es información que no aparece explícitamente en la plantilla.
Su propósito principal, como su nombre lo indica, es describir el origen del mensaje, por lo tanto, el campo utm_source es obligatorio si el objeto source existe.
Además, en este objeto se pueden enviar otros tipos de datos:
utm_medium: se usa para describir el medio del cual proviene el lead (por ejemplo: Facebook, Google, etc.).
utm_campaign: se usa para describir la campaña de la cual proviene el lead.
De todas formas, el producto ya detecta automáticamente si un lead proviene de un anuncio de Facebook o de Instagram.
Sin embargo, en este objeto source también podemos crear campos personalizados para enviar datos útiles para la conversación.
Por ejemplo, podemos definir lo siguiente:
"contact_id": 3523, "contact_interest": "Cars"
Podemos recuperar estos valores en la máquina de estados usando los siguientes placeholders:
{session.source_parameters.contact_id} {session.source_parameters.contact_interest}El primer valor puede ser útil para una solicitud API posterior en la conversación, y el segundo puede servir para iniciar la conversación y dirigirla en una dirección específica.