Integración con n8n

Envía mensajes de WhatsApp desde tus flujos de trabajo de n8n. Por ejemplo, escribe a un nuevo lead desde un webhook, confirma un pedido de tu tienda o envía una alerta cuando falla una comprobación.

Hay dos formas de conectarlo:

• El nodo de la comunidad de Wbiztool (n8n-nodes-wbiztool): nodos listos para usar con campos para cada opción.
• El nodo HTTP Request integrado: funciona en cualquier instancia de n8n y te da acceso a todos los endpoints de la API. Consulta Usar el nodo HTTP Request.

Antes de empezar#

• Una cuenta de Wbiztool con un número de WhatsApp conectado en la configuración de WhatsApp.
• Tu Client ID y tu API key de Configuración → Claves API.
• El WhatsApp Client ID del número desde el que se envía, que aparece en la configuración de WhatsApp.

Instalar el nodo de la comunidad#

1. Abre los nodos de la comunidad

   En n8n, ve a Settings → Community Nodes (configuración → nodos de la comunidad) y haz clic en Install (instalar).

2. Ingresa el nombre del paquete

   Ingresa n8n-nodes-wbiztool, confirma e instálalo. Reinicia n8n si los nodos no aparecen.

En una instancia autoalojada también puedes instalarlo con npm en la carpeta de nodos personalizados de n8n:

npm install n8n-nodes-wbiztool

Crear la credencial#

Agrega una nueva credencial de tipo WbizTool API:

Al guardar, n8n prueba la credencial con Comprobar credenciales.

Nodos#

El paquete agrega estos nodos. Cada uno llama a un endpoint de la API de Wbiztool y devuelve la respuesta de la API.

WbizTool Send Message#

El nodo devuelve messageId (el msg_id de la API). Guárdalo si quieres consultar el estado o cancelar el mensaje más adelante.

Ejemplo de flujo de trabajo#

1. El nodo Webhook recibe un nuevo lead con phone y name.
2. WbizTool Send Message: pon Phone Number en {{ $json.phone }} y Message Text en Hi {{ $json.name }}, thanks for signing up!.
3. Nodo IF: comprueba que {{ $json.messageId }} no esté vacío para continuar con el siguiente paso, como actualizar tu CRM.

Un WbizTool Send Message correcto devuelve un elemento como este:

{
  "success": true,
  "messageId": 9817263,
  "status": 1,
  "message": "Created",
  "response": { "status": 1, "message": "Created", "msg_id": 9817263 }
}

El elemento también incluye un objeto input con los valores que envió el nodo. Si la API devuelve un error, el nodo se detiene y muestra el message de la API. Activa Continue On Fail para obtener en su lugar un elemento con success: false y el texto de error.

Para WbizTool WhatsApp Client Status, usa el método de comprobación General Status. El método Status by ID devuelve un error para todos los números debido a un fallo en ese endpoint de la API. Con General Status, un número que no está conectado también detiene el nodo con un error Disconnected, así que activa la opción Continue On Fail del nodo si quieres ramificar según el resultado.

Usar el nodo HTTP Request#

Agrega un nodo HTTP Request y configúralo así:

Después pega un cuerpo como este y asigna los valores de los nodos anteriores con expresiones:

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 0,
  "country_code": "91",
  "phone": "{{ $json.phone }}",
  "msg": "Hi {{ $json.name }}, thanks for signing up!"
}

Una llamada correcta devuelve {"status": 1, "message": "Created", "msg_id": 9817263}. Todos los campos y mensajes de error están en Enviar mensaje.

Para llamar a otros endpoints, cambia la URL y el cuerpo. Por ejemplo, para programar un mensaje usa https://wbiztool.com/api/v1/schedule_msg/ y agrega date como DD/MM/YYYY, time como HH:MM y timezone. Consulta Programar mensaje.

Para enviar el mismo mensaje a varios números o grupos en una sola llamada, usa https://wbiztool.com/api/v1/send_msg/multi/ y pon los destinatarios en phone como una sola cadena separada por comas. Consulta Enviar a varios números.

{
  "client_id": 12345,
  "api_key": "YOUR_API_KEY",
  "whatsapp_client": 678,
  "msg_type": 1,
  "country_code": "91",
  "phone": "{{ $json.phones }}",
  "img_url": "https://example.com/offers/diwali-sale.jpg",
  "msg": "Our Diwali sale starts tomorrow!"
}

Pon solo dígitos en cada número. Todo lo que no sea un número entero, como 98765 43210, se envía como nombre de grupo.

Las expresiones de n8n funcionan dentro de cualquier campo de texto. Por ejemplo, un saludo que depende de la hora del día o un texto que depende del total del pedido:

{
  "msg": "Good {{ $now.hour < 12 ? 'morning' : 'evening' }} {{ $json.name }}, your order total is {{ $json.total }}.{{ $json.total > 1000 ? ' Delivery is free.' : '' }}"
}

$now usa la zona horaria del flujo de trabajo (Workflow settings → Timezone), así que configúrala para decidir cuándo termina la «mañana» (morning).

Recibir un aviso cuando se envía un mensaje#

1. Crea un flujo de trabajo con webhook

   Agrega un nodo Webhook con el método HTTP POST y copia su URL de producción.

2. Pasa la URL al enviar

   Pon esa URL en la opción Webhook URL del nodo, o en el campo webhook del cuerpo de tu solicitud HTTP.

3. Lee el resultado

   Wbiztool llama a la URL cuando el mensaje se envía o falla. El cuerpo está codificado como formulario y solo contiene msg_id y status, que es SENT o FAILED.

Consulta Webhook para ver los reintentos y los tiempos de espera.

Solución de problemas#