WhatsApp Business API con Node.js y JavaScript: Guía de integración completa

La integración de WhatsApp API con JavaScript es una solución poderosa para automatizar y personalizar la comunicación con clientes. Usando la API de 360NRS, puedes enviar mensajes mediante plantillas aprobadas, manejar conversaciones y programar notificaciones directamente desde tus aplicaciones web.

Node.js es una de las tecnologías más utilizadas para el desarrollo backend y, en combinación con la API de WhatsApp Business, permite una integración rápida, escalable y eficiente. Gracias a su arquitectura basada en eventos y su modelo asíncrono, Node.js es ideal para manejar grandes volúmenes de mensajes en tiempo real, optimizando la comunicación empresarial.

Con esta guía, aprenderás a configurar y utilizar la API para enviar mensajes, manejar respuestas y realizar otras acciones clave. Este tutorial incluye ejemplos prácticos y el código listo para usar.

---

¿Qué es la API de WhatsApp de 360NRS?

La API de WhatsApp de 360NRS permite realizar operaciones como:

• Enviar plantillas de mensajes aprobadas.
• Manejar conversaciones activas con tus usuarios.
• Consultar y programar mensajes personalizados.
• Enviar notificaciones y respuestas automáticas.

Características clave:

1. Autenticación: Basada en token mediante el encabezado Authorization.
2. Seguridad: Comunicación encriptada mediante HTTPS.
3. Flexibilidad: Admite múltiples formatos y variables en los mensajes.

Integración de la API REST de WhatsApp con Node.js y JavaScript:

• Rendimiento Asíncrono: Node.js permite manejar múltiples solicitudes simultáneamente, ideal para sistemas que requieren respuesta rápida en la mensajería.
• Escalabilidad: Su arquitectura basada en eventos es perfecta para gestionar grandes volúmenes de mensajes en tiempo real.
• Facilidad de Integración: Node.js cuenta con una amplia comunidad y numerosas librerías que facilitan la conexión con APIs REST, incluyendo WhatsApp Business API.
• Seguridad Mejorada: Compatible con autenticación basada en tokens, HTTPS y mejores prácticas para proteger la comunicación empresarial.

Cómo funciona la API de WhatsApp con Node.js y JavaScript

Envío de plantillas de mensajes con Node.js y JS

Este ejemplo demuestra cómo enviar una plantilla aprobada mediante la API.

var axios = require('axios');
var config = {
  method: 'post',
  url: 'https://dashboard.360nrs.com/api/rest/whatsapp',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Basic YOUR_AUTH_TOKEN'
  },
  data: JSON.stringify({
    "templateId": 123,
    "from": "34666777555",
    "messages": [
      { "to": "34666555444" }
    ]
  })
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Explicación del código

1. URL del endpoint: https://dashboard.360nrs.com/api/rest/whatsapp.
2. Headers:
   • Content-Type: Define el tipo de datos en el cuerpo de la solicitud.
   • Authorization: Autentica la solicitud usando un token.
3. Datos de solicitud:
   • templateId: ID de la plantilla aprobada.
   • from: Remitente autorizado.
   • messages: Lista de destinatarios y detalles del mensaje.

---

Respuestas del servidor y manejo de errores

La API responde con diferentes códigos HTTP y estructuras JSON dependiendo del estado de la solicitud.

Respuestas de éxito

• HTTP 202 (ACCEPTED): Indica que la solicitud fue aceptada.

{
  "campaignId": 100000,
  "sendingId": 100001,
  "result": [
    {
      "accepted": true,
      "to": "34666555444",
      "id": "04c80b02-8c0c-4884-bab8-89d6bc1fe406"
    }
  ]
}

Respuestas con errores parciales

• HTTP 207 (MULTI-STATUS): Algunas solicitudes fueron procesadas con errores.

{
  "campaignId": 100000,
  "sendingId": 100001,
  "result": [
    {
      "accepted": true,
      "to": "34666555444",
      "id": "8b4e5d35-dc16-4e2e-8a9c-c222db81f5ba"
    },
    {
      "accepted": false,
      "to": "34",
      "error": {
        "code": 102,
        "description": "The messages.1.to field does not contain a valid phone number"
      }
    }
  ]
}

Errores críticos

• HTTP 400 (BAD REQUEST): Problema con los parámetros de la solicitud.

{
  "error": {
    "code": 140,
    "description": "Invalid template"
  }
}

---

Parámetros de la API WhatsApp

A continuación, se presenta una tabla con los principales parámetros utilizados para configurar las solicitudes:

Parámetro	Tipo	Obligatorio	Descripción
templateId	integer	Sí	ID de la plantilla aprobada.
from	string	Sí	Número remitente autorizado.
messages	array	Sí	Lista de mensajes a enviar.
messages.*.to	string	Sí	Número de destinatario con prefijo internacional.
messages.*.bodyFields	array	No*	Variables para personalizar el cuerpo del mensaje.
campaignName	string	No	Nombre de la campaña para agrupación de estadísticas.

---

Ejemplos avanzados de WhatsApp y JavaScript con la API de 360NRS

Envío de plantilla con variables

{
  "templateId": 123,
  "from": "34666777555",
  "messages": [
    {
      "to": "34666555444",
      "headerFields": ["headerField1"],
      "bodyFields": ["bodyField1", "bodyField2"],
      "callToActionFields": ["actionField1"],
      "defaultAnswer": "Example answer",
      "buttonAnswers": ["first button answer", "second button answer"]
    }
  ]
}

Envío de plantilla con ubicación

{
  "templateId": 123,
  "from": "34666777555",
  "messages": [
    {
      "to": "34666555444",
      "location": {
        "lat": "39.92516922986921",
        "long": "-0.10572674363232447",
        "name": "NRS-Group",
        "address": "Carrer, Av. Arcadi Garcia Sanz, 19, 12540 Vila-real, Castelló"
      }
    }
  ]
}

---

Casos de uso con Node.js y WhatsApp Business API

La combinación de Node.js y WhatsApp Business API es utilizada en múltiples escenarios para mejorar la comunicación automatizada en empresas:

Casos de uso destacados:

• E-commerce: Confirmación de pedidos, notificaciones de envío y seguimiento en tiempo real.
• Atención al Cliente: Respuestas automatizadas, integración con chatbots y derivación a agentes humanos.
• Autenticación y Seguridad: Envío de códigos OTP vía WhatsApp para verificación de usuarios.
• Notificaciones Empresariales: Recordatorios de citas, alertas personalizadas y respuestas programadas.

Aplicaciones prácticas

Sectores Beneficiados

• E-commerce: Notificaciones de compras y envíos.
• Banca: Autenticaciones y alertas transaccionales.
• Salud: Recordatorios de citas y resultados.
• Educación: Confirmaciones y recordatorios de clases.

Plataformas Populares

• CRM: Gestión de clientes con integración de WhatsApp.
• Sistemas de Alertas: Integración con Nagios o herramientas similares.
• Portales Educativos: Notificaciones en Moodle y plataformas de e-learning.

---

Integrar la API de WhatsApp con JavaScript usando la plataforma de 360NRS permite a las empresas automatizar comunicaciones, mejorar la experiencia del cliente y optimizar procesos internos. Con los ejemplos y las guías proporcionadas, puedes empezar a implementar esta solución en tus aplicaciones rápidamente.

Recuerda, una integración bien configurada no solo ahorra tiempo sino que mejora significativamente la eficiencia y la satisfacción del usuario.

En conclusión, integrar la WhatsApp Business API en un entorno de desarrollo basado en Node.js y JavaScript ofrece una solución potente para automatizar la comunicación empresarial y mejorar la experiencia del usuario. Gracias a la flexibilidad de Node.js, que permite ejecutar código JavaScript en el servidor, es posible optimizar la mensajería en tiempo real con Node.js, asegurando respuestas instantáneas y escalabilidad en grandes volúmenes de mensajes.

Además, la capacidad de utilizar la API REST para WhatsApp permite a los desarrolladores conectar sus aplicaciones de manera eficiente, gestionando conversaciones, automatizando notificaciones y enviando mensajes de forma programada.

Por otro lado, implementar un backend con Node.js para WhatsApp facilita la integración con otros sistemas y bases de datos, permitiendo un control más preciso de las interacciones con los clientes y garantizando una arquitectura robusta para manejar múltiples solicitudes simultáneamente. La automatización con WhatsApp API abre la puerta a soluciones inteligentes, como chatbots, recordatorios automáticos y respuestas personalizadas, que optimizan la atención al cliente y aumentan la eficiencia operativa de cualquier negocio.

En definitiva, la combinación de Node.js, JavaScript y la API REST de WhatsApp de 360nrs brinda una plataforma versátil para desarrollar aplicaciones modernas y escalables que se integren de manera fluida con los sistemas de mensajería más utilizados en la actualidad. Adoptar estas tecnologías no solo permite mejorar la comunicación con los clientes, sino también garantizar procesos ágiles, seguros y altamente eficientes para cualquier empresa o desarrollador que busque una solución profesional de mensajería automatizada.