Enviar Mensajes
Envía mensajes WhatsApp a cualquier número.
POST/api/v1/messages/send
Parámetros
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
| to | string | Sí | Número en formato internacional sin "+". Ej: 56912345678 |
| message | string | Sí | Texto del mensaje a enviar |
| instance_id | string (uuid) | No | ID de instancia WhatsApp específica. Usa la principal si se omite. |
Ejemplos
cURL
curl -X POST https://api.atiendeapp.com/api/v1/messages/send \
-H "X-API-Key: sk_live_tu_api_key_aqui" \
-H "Content-Type: application/json" \
-d '{
"to": "56912345678",
"message": "Hola! Tu cita es mañana a las 10:00 AM."
}'Node.js
const res = await fetch('https://api.atiendeapp.com/api/v1/messages/send', {
method: 'POST',
headers: {
'X-API-Key': process.env.ATIENDEAPP_API_KEY,
'Content-Type': 'application/json'
},
body: JSON.stringify({
to: '56912345678',
message: 'Hola! Tu cita es mañana a las 10:00 AM.'
})
});
const data = await res.json();Python
import requests, os
res = requests.post(
'https://api.atiendeapp.com/api/v1/messages/send',
headers={
'X-API-Key': os.environ['ATIENDEAPP_API_KEY'],
'Content-Type': 'application/json'
},
json={
'to': '56912345678',
'message': 'Hola! Tu cita es mañana a las 10:00 AM.'
}
)
print(res.json())Respuesta exitosa (200)
{
"success": true,
"message_id": "a1b2c3d4-...",
"timestamp": "2026-05-17T14:30:00Z"
}Códigos de error
| Código | Causa |
|---|---|
| 400 | Parámetros faltantes o formato inválido |
| 401 | API Key inválida o revocada |
| 403 | Plan no Enterprise o API no habilitada |
| 429 | Rate limit excedido o quota de mensajes agotada |
| 500 | Error interno al enviar |