Wachatbot Api 2.2

Previo - Configurar un PC

Paso 1, Instalar nuestra Extensión de Google Chrome

Paso 2, Abrir Whatsapp Web

Paso 3, Escanea el código QR con teléfono móvil/celular con el que vas a hacer los envíos, y esté dado de alta en la nuestra API whatsapp.

Paso 4, Activa "Notificaciones de escritorio":

Flujo de trabajo recomendado:

1) Con .../message/send realizar los envios a lo largo del día.


2) 1 o 2 veces al día comprobar los envíos fallidos mediante .../message/erroneous, y realizar la acción oportuna con los resultados: si el número no existe en whatsapp marcarlo para no enviar más, si fué un error de envío realizar un segundo intento, etc...


3) 1 o 2 veces al día revisar la lista de usuarios dados de alta o baja mediante .../userschanges/get y procesarlos, por ejemplo: las altas añadirlas a listados para futuros envíos, las bajas quitarlas/bloquearlas para no enviar más, etc...


4) 1 vez al día, o cada 2 días, recomendamos comprobar el tamaño de la cola de mensajes pendientes para asegurarnos que no hay una gran cantidad de ellos y por tanto que los está enviando bien para lo que usas .../message/pending, es útil para detectar si la extensión está parada, el Chrome cerrado, si la velocidad a la que le estás enviando los mensajes a nuestro servidor es mucho mayor de la que se pueden enviar por Whatsapp, etc... si se llena la cola de pendientes con muchos mensajes es útil usar .../message/clear para borrar la cola de mensajes pendientes de días anteriores y comenzar a enviar los mensajes de ese día, mientras se resuelve el problema que causó es congestión

Enviar Whatsapp

https://app.wachatbot.com:12345/api/message/send

(POST) application/x-www-form-urlencoded

Ejemplo de petición: targetPhone=34667207231&message=Mensaje&token=XXX-XXX-XXX-XXXXX

Respuesta correcta (JSON): {"status" : "success", "message_id": "1234"}

Respuesta incorrecta (JSON): {"status" : "error", "summary": "..."}

*message_id: es el id. del mensaje, sirve para comprobar si hubo un fallo en le envio

Ejemplo Php 7 (file_get_contents)

Ejemplo Php 7 (curl_init)

Ejemplo Visual Basic

Ejemplo VisualFoxPro

Ejemplo Curl

Obtener el número total de Whatsapps enviados correctamente

https://app.wachatbot.com:12345/api/message/totalsent

(POST) application/x-www-form-urlencoded

Ejemplo de petición: token=XXX-XXX-XXX-XXXXX

Respuesta correcta (JSON): {"count" : 1253}

Respuesta incorrecta (JSON): {"status" : "error", "summary": "..."}

Ejemplo Php 7 (file_get_contents)

Ejemplo Php 7 (curl_init)

Ejemplo Visual Basic

Ejemplo VisualFoxPro

Ejemplo Curl

Listar Mensajes Envío Fallido

https://app.wachatbot.com:12345/api/message/erroneous

(POST) application/x-www-form-urlencoded

Ejemplo de petición: token=XXX-XXX-XXX-XXXXX

Respuesta (JSON): [ { "message_id" : 23, "message_error": "unknown" }, { "message_id" : 19, "message_error": "no_whatsapp_phone" }, { "message_id": 17, "message_error": "no_whatsapp_phone" } ]

* Devuelve la lista de mensajes que dieron algún tipo de error al intentar enviarlos, en caso de que el teléfono no sea un número registrado con Whatsapp devuelve el error 'no_whatsapp_phone', si no devuelve el error genérico 'unknown'

Ejemplo Php 7 (file_get_contents)

Ejemplo Php 7 (curl_init)

Ejemplo Visual Basic

Ejemplo VisualFoxPro

Ejemplo Curl

Listar Mensajes Pendientes de Envío

https://app.wachatbot.com:12345/api/message/pending

(POST) application/x-www-form-urlencoded

Ejemplo de petición: token=XXX-XXX-XXX-XXXXX

Respuesta (JSON): [ { "message_id" : 23 }, { "message_id" : 19 }, { "message_id": 17 } ]

* Devuelve la lista de mensajes pendientes de enviar

Ejemplo Php 7 (file_get_contents)

Ejemplo Php 7 (curl_init)

Ejemplo Visual Basic

Ejemplo VisualFoxPro

Ejemplo Curl

Listar Usuarios dados de Alta/Baja/Lista Negra

https://app.wachatbot.com/api/userschanges/get

GET (text/plain)

Ejemplo de petición: https://app.wachatbot.com/api/userschanges/get?date=2019-10-01&token=XXX-XXX-XXX-XXXXX

Respuesta (JSON):

{"contacts":[
{ "phone" : "XXXXXXXXXXX", "status" : "1", "date" : "5/15/2020 4:10:46 PM", "group": "(general)"},
{ "phone" : "XXXXXXXXXXX", "status" : "0", "date" : "4/27/2020 10:19:44 AM"}, "group": ""}
{ "phone" : "XXXXXXXXXXX", "status" : "-1", "date" : "5/27/2020 10:19:44 AM"}, "group": ""}
]}

* Devuelve la lista de usuarios indicando si enviaron el mensaje de alta (status = 1) de baja (status = 0) o si se añadieron manualmente a la lista negra (status = -1) en una fecha igual o posterior a la indicada en el parámetro date. También devuelve la fecha (YYYY-MM-DD), hora (UTC) en que lo hicieron, y el grupo en el que se dió de alta (en caso de status=1). Si se dió de baja o se añadió a la lista negra el nombre del grupo lo devuelve en blanco.

Ejemplo Php 7 (file_get_contents)

Ejemplo Php 7 (curl_init)

Ejemplo Curl

Bloquear un usuario para que no se le envíen más mensajes

https://app.wachatbot.com/api/userschanges/block

GET (text/plain)

Ejemplo de petición: https://app.wachatbot.com/api/userschanges/block?phone=55555555&token=XXX-XXX-XXX-XXXXX

Respuesta (JSON):

{"contacts":[
{ "phone" : "55555555", "status" : "blocked"},
]}

Ejemplo Php 7 (file_get_contents)

Ejemplo Php 7 (curl_init)

Ejemplo Curl

Limpiar lista de Mensajes Pendientes

https://app.wachatbot.com:12345/api/message/clear

(POST) application/x-www-form-urlencoded

Ejemplo de petición: token=XXX-XXX-XXX-XXXXX

Respuesta (JSON): { "status" : "ok" }

* Elimina la lista de mensajes pendientes de enviar

Ejemplo Php 7 (file_get_contents)

Ejemplo Php 7 (curl_init)

Ejemplo Visual Basic

Ejemplo VisualFoxPro

Ejemplo Curl