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
$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;
}
$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;
}
﻿
JSON de respuesta
{
  "code": 200,
  "error": 0,
  "message": "Ticket created",
  "data": {
    "ticket_id": "1Q4W0"
  }
}
{
  "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} ]
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.
PHP
tags: ["IG039"]
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í:
PHP
template_parameters: ["Nicolás", "$3.200"]
template_parameters: ["Nicolás", "$3.200"]
﻿
En este ejemplo, la plantilla en cuestión tiene dos parámetros: nombre y monto.

Updated 07 Sep 2023

Did this page help you?

POST /tickets

Webhook

Docs powered by Archbee

TABLE OF CONTENTS

Conversaciones con mensajes salientes

Conversaciones en blanco

Parámetros

Campos personalizados

Etiquetas

Plantilla aprobada por Whatsapp

Parámetros de la plantilla

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.