La integración de WhatsApp Business API con PHP a través 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.
Contenidos
- ¿Qué es la API de WhatsApp de 360NRS?
- Envío de plantillas de WhatsApp Business con PHP
- Respuestas del servidor y manejo de errores con WhatsApp PHP API
- Parámetros principales de la API
- Ejemplos adicionales de envíos de WhatsApp con PHP y la API de 360NRS
- Casos de uso de WhatsApp PHP API
- Integración avanzada y seguridad en WhatsApp Business PHP API
¿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:
- Seguridad: Autenticación mediante token y cifrado HTTPS.
- Flexibilidad: Admite diferentes formatos y opciones en los mensajes.
- Escalabilidad: Soporta envío masivo y personalizado de mensajes.
Envío de plantillas de WhatsApp Business 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 Business 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
- Inicialización de cURL: Se configura el cliente HTTP para realizar la solicitud
POST. - 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.
- 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
- Automatización en E-commerce:
- Confirmaciones de pedidos.
- Notificaciones de envío.
- Alertas Bancarias:
- Recordatorios de pagos.
- Alertas de transacciones.
- 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.
Integración avanzada y seguridad en WhatsApp Business PHP API
Una vez implementada la integración básica, es crucial asegurar que la comunicación con la WhatsApp Business PHP API sea robusta y cumpla con los más altos estándares de seguridad. A continuación, se detallan las prácticas recomendadas para optimizar tu integración:
Gestión segura de tokens y autenticación
- Uso de variables de entorno: Almacena las credenciales y tokens de forma segura, evitando exponer información sensible en el código.
- Refresco automático de tokens: Implementa mecanismos para actualizar el token antes de su expiración, garantizando la continuidad de la autenticación.
Configuración y uso de Webhooks
- Notificaciones en tiempo real: Configura webhooks para recibir actualizaciones instantáneas sobre el estado de los mensajes, errores y respuestas de los usuarios.
- Endpoints dedicados: Desarrolla endpoints específicos y seguros para procesar los eventos de los webhooks, facilitando la gestión y monitorización de la integración.
Manejo avanzado de errores y logging
- Control de errores: Diseña estrategias robustas para manejar respuestas exitosas, errores parciales y críticos, basándote en los códigos de estado HTTP.
- Registro detallado (Logging): Utiliza herramientas como Monolog para capturar y analizar las peticiones y respuestas, lo que facilita la depuración y mejora continua del sistema.
Optimización de la aquitectura de integración
- Modularidad: Estructura tu código en módulos (autenticación, envío de mensajes, gestión de webhooks) para facilitar el mantenimiento y la escalabilidad.
- Patrones de diseño: Aplica patrones de diseño (por ejemplo, MVC) que permitan una organización clara y un desarrollo ágil del proyecto.
Certificación ISO 27001 y cumplimiento de seguridad
- Certificado ISO 27001: Nuestra plataforma cuenta con la certificación ISO 27001, garantizando rigurosos controles de seguridad y las mejores prácticas en la protección de datos.
- Compromiso con la seguridad: La integración se realiza en un entorno seguro, utilizando conexiones HTTPS y auditorías periódicas para asegurar la integridad y confidencialidad de la información empresarial.
Implementar estas prácticas avanzadas no solo mejora la eficiencia y estabilidad de la integración, sino que también refuerza la seguridad de las comunicaciones.
La certificación ISO 27001 de la plataforma es una garantía adicional de nuestro compromiso con la protección de la información, ofreciendo a desarrolladores y empresas una solución confiable y de alta calidad.
También te puede interesar:
API de WhatsApp: Automatiza y gestiona tus mensajes
Jaime Martínez – Product Manager 360NRS
Jaime Martínez, Product Manager en 360NRS, experto en comunicaciones móviles, marketing online, diseño, usabilidad y gestión de producto. Con más de 20 años de experiencia en el sector, Jaime ha liderado el desarrollo y evolución de productos digitales, impulsando estrategias centradas en el usuario que optimizan tanto la experiencia como el rendimiento de las soluciones. Su amplia trayectoria en diseño, marketing digital y gestión de producto aporta una visión estratégica clave para la innovación y el éxito de nuestras soluciones multicanal.
Deja una respuesta