Hoy te guiaremos paso a paso sobre cómo utilizar cURL en Shell para enviar mensajes de WhatsApp, recuperar conversaciones activas y responder mensajes con la API de 360nrs.
Explicaremos cada comando en detalle, proporcionando ejemplos prácticos y destacando las mejores prácticas para asegurar una implementación eficiente y segura.
Contenidos
Enviar un mensaje de WhatsApp con una plantilla usando cURL
¿Qué hace este comando?
Este comando realiza una solicitud POST a la API de WhatsApp Business de 360nrs con el objetivo de enviar un mensaje utilizando una plantilla previamente aprobada. El mensaje se enviará desde un número registrado en la plataforma (from) hacia un destinatario específico (to). Este proceso es fundamental para empresas que desean automatizar la comunicación con sus clientes a través de mensajes estructurados en WhatsApp.
El uso de cURL en Shell facilita la integración sin necesidad de depender de lenguajes de programación adicionales, permitiendo la ejecución de solicitudes HTTP de manera rápida y eficiente. En este caso, la plantilla identificada por templateId se utilizará como base para el mensaje enviado, asegurando que el contenido cumpla con las políticas de WhatsApp Business.
Explicación del comando:
curl -X POST 'https://dashboard.360nrs.com/api/rest/whatsapp'→ Especifica que la solicitud es POST a la API de WhatsApp.-H 'Content-Type: application/json'→ Indica que el contenido de la solicitud está en formato JSON.-H 'Authorization: Basic YOUR_AUTH_TOKEN'→ Autenticación usando un token API.-d '{JSON_DATA}'→ Define el cuerpo de la solicitud con los datos del mensaje.
Comando cURL para enviar un mensaje de WhatsApp:
curl -X POST 'https://dashboard.360nrs.com/api/rest/whatsapp' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic YOUR_AUTH_TOKEN' \
-d '{
"templateId": 123,
"from": "34666777555",
"messages": [
{
"to": "34666555444"
}
]
}'
Posibles respuestas del servidor:
Al realizar una solicitud a la API de 360nrs, el servidor puede responder con diferentes códigos HTTP, indicando el estado de la operación:
| Código HTTP | Descripción |
|---|---|
| 202 Accepted | El mensaje ha sido aceptado correctamente y se procesará para su entrega. |
| 207 Multi-Status | Se han procesado múltiples mensajes en la misma solicitud; algunos pueden haber fallado. |
| 400 Bad Request | La solicitud contiene errores, como una plantilla no aprobada o un número de teléfono en formato incorrecto. |
Es importante manejar estas respuestas adecuadamente para asegurar que los mensajes sean enviados correctamente y poder depurar cualquier error en caso de fallos.
Ejemplo de respuesta exitosa (202 Accepted):
{
"campaignId": 100000,
"sendingId": 100001,
"result": [
{
"accepted": true,
"to": "34666555444",
"id": "04c80b02-8c0c-4884-bab8-89d6bc1fe406"
}
]
}
Obtener el listado de conversaciones activas
¿Qué hace este comando?
Este comando realiza una solicitud GET a la API de 360nrs para obtener un listado de todas las conversaciones activas en la cuenta del usuario. La API devuelve información clave como el número del remitente (from), el destinatario (to), el número total de mensajes en la conversación y el estado de la sesión (isSessionActive).
Consultar las conversaciones activas es útil para empresas que necesitan monitorear interacciones en tiempo real, gestionar respuestas automáticas o realizar un seguimiento de la actividad de sus clientes dentro de WhatsApp Business.
Con esta información, es posible analizar el comportamiento del usuario y optimizar estrategias de comunicación.
Comando cURL para obtener conversaciones activas:
-X GET 'https://dashboard.360nrs.com/api/rest/whatsapp/conversations' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic YOUR_AUTH_TOKEN'
Ejemplo de respuesta JSON:
{
"data": [
{
"from": "34666777555",
"to": "34666555444",
"totalMessages": 10,
"status": "OPEN",
"isSessionActive": true
}
]
}
Obtener los mensajes de una conversación específica
¿Qué hace este comando?
Este comando recupera todos los mensajes de una conversación específica entre dos números.
Comando cURL para obtener los mensajes de una conversación:
-X GET 'https://dashboard.360nrs.com/api/rest/whatsapp/conversations/34666777555/34666555444/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic YOUR_AUTH_TOKEN'
Ejemplo de respuesta JSON:
{
"data": [
{
"id": "f564433e-7cd1-47fa-af98-1bd632411b26",
"type": "text",
"content": "User response",
"sentAt": "2024-01-01T11:00:00+00:00"
}
]
}
Enviar un mensaje a una conversación activa
¿Qué hace este comando?
Este comando envía un mensaje de texto a una conversación activa.
Comando cURL para enviar un mensaje:
curl -X POST 'https://dashboard.360nrs.com/api/rest/whatsapp/conversations/34666777555/34666555444/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic YOUR_AUTH_TOKEN' \
-d '{
"content": "Hola, ¿cómo puedo ayudarte?"
}'
📌 Nota: Solo se pueden enviar mensajes a conversaciones con sesión activa (isSessionActive: true).
Buenas prácticas en la integración con cURL y la API de WhatsApp Business
✅ Gestión de Sesiones: Antes de enviar mensajes, verifica si la sesión está activa (isSessionActive).
✅ Manejo de Errores: Captura respuestas 400 y 207 para diagnosticar fallos en el envío de mensajes.
✅ Seguridad: Nunca compartas tu YOUR_AUTH_TOKEN en código público.
✅ Optimización de Consultas: Usa parámetros como limit para reducir la carga de datos en respuestas JSON.
Empieza hoy mismo con la API de WhatsApp Business en 360nrs
La integración de la API de WhatsApp Business con cURL es una solución rápida y eficiente para automatizar mensajes y gestionar conversaciones sin necesidad de software adicional.
✔️ Automatiza la comunicación de tu empresa.
✔️ Integra WhatsApp en tu infraestructura con facilidad.
✔️ Responde a tus clientes en tiempo real.
Regístrate ahora en 360nrs.com y prueba la API GRATIS para comenzar a enviar mensajes de WhatsApp con cURL y optimizar la comunicación de tu empresa.
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.
