Escenario

1. ZOHO CRM
   
1. Calificar Leads: Cuando recibes un mensaje de un nuevo cliente potencial, puedes hacer algunas preguntas automáticas para ahorrar tiempo a tus agentes
   
2. Fuera de servicio: cuando recibes un mensaje el fin de semana, puedes automatizar la respuesta, según el tiempo, según el tipo de cliente, según las palabras utilizadas, etc.
   
3. Enviar promoción: antes de que se cierre la ventana de 24, puedes enviar un mensaje automatizado con una promoción, hacer una pregunta ficticia o lanzar un mensaje divertido. Si tu cliente te responde, tendrás 24 horas la ventana abierta.
   
4. Un recordatorio de reunión: cada vez que visites a un cliente o hagas una reunión en línea, puedes enviar un mensaje de plantilla para asegurarte de que tu cliente lo recordará.
   
2. ZOHO DESK
   
1. Base de conocimiento: puedes automatizar la primera respuesta con un mensaje fijo que explique dónde está tu base de conocimiento, o puedes automatizar la búsqueda en tu base de conocimiento y responder con los artículos relacionados.
   
2. Llamada perdida: cuando tienes una llamada perdida a tu departamento de Atención al Cliente, puedes enviar un mensaje proponiendo usar WhatsApp para contactarlo.
   
3. ZOHO BOOKS
   
1. Factura enviada: cada vez que envías una factura a tu cliente por correo electrónico, puedes avisarle o enviarle el enlace para realizar el pago.
   
4. ZOHO RECRUIT
   
1. Una nueva oferta de trabajo para los candidatos: puedes automatizar la alerta a los candidatos cada vez que publiques una nueva oferta de trabajo que coincida con un segmento de tus candidatos.
   
5. ZOHO HUB
   
1. Nutre: Administra tu flujo de leads
   
6. etc
   

Algunos de estos ejemplos pueden necesitar experiencia en la configuración de sus aplicaciones ZOHO. Ponte en contacto con un partner experimentado de WOZTELL o contáctanos para contarnos tus necesidades.

FAQ

1. ¿Cuál es el límite de mensajes salientes? WOZTELL no te limita. Puede enviar tantos mensajes como permitan tus herramientas ZOHO.
   
2. ¿Puedo enviar plantillas y mensajes de sesión? Sí, puedes enviar ambos
   
3. ¿Cuántos segundos se necesitan para enviar un lote de 1.000 mensajes? El tiempo exacto depende de varias variables, pero generalmente se puede enviar en 250 segundos. Si necesita más velocidad, comunícate con presales@woztell.com para estudiar tus requisitos.
   
4. ¿Puedo enviar archivos? En realidad, los webhooks de WOZTELL no te permiten incluir archivos. Si lo necesitas, puedes incluir una URL con el enlace al archivo que deseas enviar.
   
5. ¿Puedo enviar mensajes usando otras aplicaciones que no sean de ZOHO? Los planes actuales te permiten usar webhooks lanzados desde servidores ZOHO. Podemos abrir el servicio a otros escenarios según tus necesidades. Por favor, ponte en contacto con presales@woztell.com
   

Si encuentras alguna limitación en el uso de Webhooks, por favor, contáctanos para estudiar tus necesidades en presales@woztell.com

VÍDEO: Cómo usar un Webhook dentro de un WorkFlow de ZOHO CRM

Alcance del documento

1. Pre-requisitos
   
2. Solicitudes
   
1. Formato de números de teléfono
   
2. Envío de URLs en mensajes de texto
   
3. Aplicar formato en mensajes de texto
   
3. Respuesta
   
4. Ejemplo
   
5. Control de corte
   

Pre-requisitos

1. Cuenta de Woztell activada
   

1. Para usar la API de Woztell, primero debes autenticarte y recibir un token que te permita acceder al servicio. Ponte en contacto con support@woztell.com para obtener más información sobre cómo hacerlo.
   
2. El mensaje debe cumplir con los requisitos del servicio de control de corte.
   

Solicitudes

Las llamadas a la API de mensajes se envían al endpoint  /messages independientemente del tipo de mensaje, pero el contenido del cuerpo del mensaje JSON difiere para cada tipo de mensaje (texto o plantillas). Consulta la siguiente documentación para obtener información sobre el tipo de mensajes que deseas enviar:

POST https://webservice.woztell.com/webhook/messages

Parámetros:

Nombre de parámetro	Tipo de dato	Descripción	Posibles Valores
WOZTELL_ADMIN*	String	Dirección del correo electrónico de tu cuenta de Woztell.	admin@company.com
WOZTELL_TOKEN*	String	Tu token de la cuenta de Woztell.	abc-defgh-ijk-123
WOZTELL_NUMBER	String	Número de teléfono de Woztell validado por WhatsApp. Si no envías ningún número, se usará el número principal de WhatsApp	"+1-631-555-1002", "16315551002", "001(631)555-1002"or "1 631 555 1002"
DATA	JSON	Consulta la siguiente documentación en la sección Parámetros de datos.

1. Mensaje de texto
   

POST https://webservice.woztell.com/webhook/messages
{
 "WOZTELL_ADMIN":"your-woztell-admin-email",
 "WOZTELL_TOKEN":"your-woztell-token",
 "DATA":
 {
 "TO":"whatsapp-number",
 "MESSAGE":"your-message-text",
 "USER":"issuer-name"
 } }

POST https://webservice.woztell.com/webhook/messages
{
 "WOZTELL_ADMIN":"your-woztell-admin-email",
 "WOZTELL_TOKEN":"your-woztell-token",
 "DATA":
  {
   "TO":"whatsapp-number",
   "TEMPLATE":"your-template-code",
 "PARAMETER 1":"your-parameter-1-value",
 ...
 "PARAMETER 10":"your-parameter-10-value"
   "USER":"issuer-name"
  } }

Formatos de números de teléfono

La mejor práctica recomendada es especificar el código del país con el número de teléfono, agregando siempre y explícitamente el prefijo más el signo (+).

Número de teléfono	Número de teléfono traducido
"+1-631-555-1002"	"+16315551002"
"6315551002"	"+6315551002" (inválido)
"1-631-555-1002"	"+16315551002"
001 (516) 283-7151"	"+15162837151"
"+54 9 11 5612-1008"	"+5491156121008"

Enviar URL en mensajes de texto

Por defecto, la aplicación móvil de WhatsApp reconoce las URL y las hace interactivas. Para incluir una vista previa de la URL, asegúrate de que la URL comienza con  http:// o  https://. También se requiere un nombre de host, ya que las direcciones IP no coinciden.

Aplicar formato en mensajes de texto

{
 "STATUS":"ERROR",
 "DESCRIPTION":"INVALID JSON DATA" }

{
 "STATUS":"SUCCESS",
 "IDMESSAGE":"whatsapp-message-id",
 "DESCRIPTION":"" }

Ejemplo

POST https://webservice.woztell.com/webhook/messages
{
 "WOZTELL_ADMIN":"admin@woztell.com",
 "WOZTELL_TOKEN":"123-45678-90abcdefg-hij-klmn",
 "DATA":
  {
   "TO":"00123456789",
   "MESSAGE":"Hello World!",
   "USER":"John Woztell"
  } }

<?php
$curl = curl_init();
 
curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://webservice.woztell.com/webhook/messages',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => 
 array(
  'WOZTELL_ADMIN' => 'admin@woztell.com',
  'WOZTELL_TOKEN' => '123-45678-90abcdefg-hij-klmn',
  'DATA' => '{
    "TO":"00123456789",
    "MESSAGE":"Hello world!",
    "USER":"John Woztell"
    }'
  ),
));
 
$response = curl_exec($curl);
 
curl_close($curl); echo $response;

Control de corte

1. Los mensajes de texto regulares (es decir, cualquier mensaje que no sea de plantilla) solo se pueden entregar en las 24 horas posteriores a la última vez que el cliente envió un mensaje a tu empresa.
   
2. Los mensajes de plantilla no tienen esta restricción y deberían ser la forma preferida de llegar a un cliente.
   
3. La cuenta comercial debe ser elegible para pagos.
   

Si necesitas más ayuda, por favor contáctanos en support@woztell.com