⌘K
Bienvenido
Conceptos básicos
Agente vs Colaborador
Ciclo de una conversación
Partes de una conversación
Configuración inicial
Departamentos
Canales de atención
Webchat
WhatsApp
Facebook
Instagram
Telegram
eMail
Microsoft Teams
Gestión de agentes
Respuestas rápidas
Etiquetas
Notas privadas y menciones
Asignar una conversación
API
GET /users
POST /tickets
Formulario a Conversación
Webhook
Soporte al cliente
Docs powered by Archbee
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;
}

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.

PHP
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"]


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

Updated 07 Sep 2023
Did this page help you?
PREVIOUS
POST /tickets
NEXT
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
Docs powered by Archbee