API

Formulario a Conversación

9min

Capturar y generar conversaciones en AsisteClick puede no ser tan obvio al momento de construir un formulario para tu sitio o proyecto web. Por eso, en este tutorial te mostraremos cómo configurar eventos y acciones en tus páginas para que la información que recojas desencadene una interacción con tus clientes, creando así conversaciones efectivas y personalizadas.

El proceso de configuración incluirá la implementación de código PHP para capturar la información necesaria y utilizarla como punto de partida para iniciar una conversación con tus clientes a través de AsisteClick. Con estas instrucciones paso a paso, podrás aprender cómo aprovechar al máximo esta herramienta y mejorar la comunicación con tus usuarios.

No importa si eres un principiante o un desarrollador experimentado, este tutorial te guiará a través de todo el proceso de configuración y te brindará todas las herramientas necesarias para crear conversaciones efectivas y transaccionales en tu sitio web o proyecto. Estamos seguros de que después de seguir estos pasos, podrás utilizar AsisteClick para optimizar la interacción con tus clientes y aumentar la satisfacción del usuario en tu sitio web.

Las conversaciones generadas a partir de los datos de un formulario pueden generar tanto conversaciones con mensaje saliente al cliente como conversaciones sin mensaje saliente. Esto dependerá de las circunstancias y las acciones que se quieran luego de obtener los datos del formulario.

Conversaciones con mensajes salientes

A continuación, se presentan ejemplos que muestran el proceso de creación de una conversación con mensaje saliente en los canales de WhatsApp y correo electrónico para nuestros clientes. Estas ilustraciones prácticas te ayudarán a comprender cómo establecer comunicaciones efectivas con tus clientes a través de estos canales.

PHP a WhatsApp
PHP a eMail

JSON de respuesta


Conversaciones en blanco

Parámetros

Los parámetros en este formulario son:

Campo

Descripción



TOKEN

El token de la cuenta en AsisteClick.

↗️

deptid_assigned

El ID del departamento al cual se vincula la conversación.

↗️

userid_assigned

En caso de querer asignar también la conversación a un usuario en particular colocar acá el ID del usuario.

↗️

status

OPEN / CLOSE



customer_name

El nombre del cliente.



customer_email

El correo electrónico del cliente.



customer_phone

El teléfono del cliente en formato Whatsapp.



channel

WHATSAPP / EMAIL



source_id

El número de WhatsApp integrado en AsisteClick por el cual se enviará el mensaje.



subject

El título de la conversación (solo visible por los usuarios en caso que canal = WHATSAPP).



custom_fields

Vector con valors para campos personalizados (opcional).



tags

Vector con etiquetas de la conversación (opcional).



template_id

El ID de la plantilla aprobada por WhatsApp que se enviará al cliente.

↗️

template_parameters

En caso que la plantilla tenga parámetros aquí se especifican los valores en un vector de strings.



Campos personalizados

Puedes agregar metadata a la conversación mediante campos personalizados que serán visibles en la columna derecha de la conversación. Estos datos también pueden ser utilizados para realizar búquedas en las conversaciones.

El valor del campo custom_fields debe ser un vector de objetos, así:



Etiquetas

Utiliza etiquetas si quieres agrupar conversaciones. Las etiquetas serán visibles en la columna derecha de la la conversación. Estos datos también pueden ser utilizados en los reportes de etiquetas.

PHP


Plantilla aprobada por Whatsapp

La plantilla debe estar previamente aprobada por WhatsApp. Puedes solicitar plantillas a través de Savitar, nuestro chatbot integrado con META para la gestión de plantillas.

Una vez que tu plantilla esté aprobada encontrarás su ID en la sección de Respuestas Rápidas.

Parámetros de la plantilla

En caso que la plantilla contenga parámetros estos se especifican en un vector, así:

PHP


En este ejemplo, la plantilla en cuestión tiene dos parámetros: nombre y monto.

Updated 07 Sep 2023
Doc contributor
Did this page help you?