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 $request = new httprequest(); $request >seturl('https //api asisteclick com/v2/tickets'); $request >setmethod(http meth post); $request >setheaders(\[ 'content type' => 'application/json', 'token' => '\<token>' ]); $request >setbody('{ "deptid assigned" 123, "userid assigned" 12345, "status" "open", "customer name" $ post\["nombre"], "customer email" $ post\["correo"], "customer phone" $ post\["telefono"], "channel" "whatsapp", "source id" 5491170052719, "subject" "envío de plantilla por whatsapp", "custom fields" null, "tags" null, "template id" 1234, "template parameters" \["pepe", "juan"] } '); try { $response = $request >send(); echo $response >getbody(); } catch (httpexception $ex) { echo $ex; } php a email $request = new httprequest(); $request >seturl('https //api asisteclick com/v2/tickets'); $request >setmethod(http meth post); $request >setheaders(\[ 'content type' => 'application/json', 'token' => '\<token>' ]); $request >setbody('{ "deptid assigned" 123, "userid assigned" 12345, "status" "open", "customer name" $ post\["nombre"], "customer email" $ post\["correo"], "customer phone" $ post\["telefono"], "channel" "email", "source id" null, "subject" "envío de mensaje por email", "custom fields" null, "tags" null, "message" "hola!!, esto es un mensaje mensaje al cliente", "is private" false }'); try { $response = $request >send(); echo $response >getbody(); } catch (httpexception $ex) { echo $ex; } json de respuesta { "code" 200, "error" 0, "message" "ticket created", "data" { "ticket id" "1q4w0" } } 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í custom fields \[ {"campaign" "ig039"}, {"cliente" 123} ] 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 tags \["ig039"] 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í template parameters \["nicolás", "$3 200"] en este ejemplo, la plantilla en cuestión tiene dos parámetros nombre y monto