WhatsApp PHP API

La integración de WhatsApp API con PHP a trav´res de 360NRS es una solución práctica y eficiente para automatizar la comunicación empresarial. Con el uso de la API de 360NRS, puedes enviar plantillas de mensajes aprobadas, gestionar conversaciones y enviar notificaciones personalizadas desde tu aplicación web. PHP, siendo uno de los lenguajes más populares para desarrollo web, permite una integración ágil y segura con la API.

En este artículo, exploraremos cómo implementar esta solución paso a paso, con ejemplos listos para usar y detalles de las funcionalidades disponibles.

---

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

La API de WhatsApp de 360NRS es una herramienta potente diseñada para empresas que buscan gestionar la comunicación con sus clientes mediante WhatsApp. Las principales funcionalidades incluyen:

• Envío de plantillas personalizadas: Utiliza plantillas aprobadas para enviar mensajes.
• Gestión de conversaciones activas: Controla las interacciones con tus usuarios.
• Notificaciones y respuestas: Automatiza notificaciones transaccionales y envía respuestas automáticas.

Características principales:

1. Seguridad: Autenticación mediante token y cifrado HTTPS.
2. Flexibilidad: Admite diferentes formatos y opciones en los mensajes.
3. Escalabilidad: Soporta envío masivo y personalizado de mensajes.

---

Configuración básica: Envío de plantillas con PHP

El siguiente ejemplo muestra cómo enviar una plantilla aprobada a través de la API.

Código de envío de plantilla WhatsApp PHP API

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://dashboard.360nrs.com/api/rest/whatsapp',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => '{
    "templateId": 123,
    "from": "34666777555",
    "messages": [
        {
            "to": "34666555444"
        }
    ]
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'Authorization: Basic YOUR_AUTH_TOKEN'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
?>

Explicación del código

1. Inicialización de cURL: Se configura el cliente HTTP para realizar la solicitud POST.
2. Encabezados:
   • Content-Type: application/json: Indica que el cuerpo de la solicitud está en formato JSON.
   • Authorization: Basic YOUR_AUTH_TOKEN: Autenticación mediante un token básico.
3. Cuerpo de la solicitud:
   • templateId: ID de la plantilla que será enviada.
   • from: Número remitente autorizado.
   • messages: Lista de destinatarios.

---

Respuestas del servidor y manejo de errores con WhatsApp PHP API

El servidor de la API devuelve diferentes códigos HTTP y estructuras JSON según el resultado de la solicitud.

Respuestas de éxito

• HTTP 202 (ACCEPTED): La solicitud fue procesada correctamente.

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

Respuestas parcialmente correctas

• HTTP 207 (MULTI-STATUS): Algunos mensajes se enviaron, otros fallaron.

jsonCopiar código{
  "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"
      }
    }
  ]
}

Respuestas de error

• HTTP 400 (BAD REQUEST): La solicitud contiene errores.

jsonCopiar código{
  "error": {
    "code": 140,
    "description": "Invalid template"
  }
}

---

Parámetros principales de la API

A continuación, se describen los parámetros necesarios para realizar solicitudes exitosas:

Parámetro	Tipo	Requerido	Descripción
templateId	integer	Sí	ID de la plantilla aprobada.
from	string	Sí	Número autorizado como remitente.
messages	array	Sí	Lista de destinatarios y detalles de los mensajes.
messages.*.to	string	Sí	Número de teléfono del destinatario (con prefijo internacional).
messages.*.bodyFields	array	No	Variables dinámicas para personalizar el mensaje.
campaignName	string	No	Nombre de la campaña asociada al envío.

---

Ejemplos adicionales de envíos de WhatsApp con PHP y la API de 360NRS

Envío de plantilla con variables

{
  "templateId": 123,
  "from": "34666777555",
  "messages": [
    {
      "to": "34666555444",
      "headerFields": ["Header Value"],
      "bodyFields": ["Body Value 1", "Body Value 2"],
      "callToActionFields": ["CTA Value"]
    }
  ]
}

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ó"
      }
    }
  ]
}

Envío de mensajes a conversaciones activas

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://dashboard.360nrs.com/api/rest/whatsapp/conversations/34666777555/34666555444/messages',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => '{
    "content": "Message content"
}',
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json',
    'Authorization: Basic YOUR_AUTH_TOKEN'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
?>

---

Casos de uso de WhatsApp PHP API

1. Automatización en E-commerce:
   • Confirmaciones de pedidos.
   • Notificaciones de envío.
2. Alertas Bancarias:
   • Recordatorios de pagos.
   • Alertas de transacciones.
3. Atención al Cliente:
   • Respuestas automáticas a consultas frecuentes.
   • Seguimiento de casos.

---

La integración de la API de WhatsApp con PHP utilizando la plataforma 360NRS permite automatizar la comunicación, mejorar la eficiencia y brindar una mejor experiencia a los usuarios. Con las guías y ejemplos proporcionados, puedes implementar esta solución en tu sistema de forma rápida y efectiva.