API Reference

Documentaci贸n para enviar mensajes de WhatsApp a trav茅s de InnovaAPI.

Autenticaci贸n

Todas las solicitudes requieren tu API Key en el header:

Authorization: Bearer TU_API_KEY
Tu API Key te la proporciona el administrador de InnovaAPI. No la compartas con nadie.
POST /api/whatsapp/enviar
Par谩metros
Campo Tipo Descripci贸n
numero requerido string N煤mero con c贸digo de pa铆s. Ej: 573001234567
tipo requerido string text | image | document | video | audio | location
mensaje string Texto del mensaje. Requerido si tipo es text
url string URL del archivo. Requerido para image, document, video, audio
caption string Texto opcional debajo de la imagen o video
latitud number Latitud. Requerido para location
longitud number Longitud. Requerido para location
nombre string Nombre del lugar. Opcional para location
Ejemplos de C贸digo
Texto
const res = await fetch('https://TU_SERVIDOR/api/whatsapp/enviar', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer TU_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    numero: '573001234567',
    tipo: 'text',
    mensaje: 'Hola, este es un mensaje de prueba'
  })
});

const data = await res.json();
// { success: true, message: 'Mensaje enviado correctamente' }
Imagen
const res = await fetch('https://TU_SERVIDOR/api/whatsapp/enviar', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer TU_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    numero: '573001234567',
    tipo: 'image',
    url: 'https://ejemplo.com/imagen.jpg',
    caption: 'Mira esta imagen'
  })
});
Ubicaci贸n
const res = await fetch('https://TU_SERVIDOR/api/whatsapp/enviar', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer TU_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    numero: '573001234567',
    tipo: 'location',
    latitud: 4.7110,
    longitud: -74.0086,
    nombre: 'Bogot谩, Colombia'
  })
});
Texto
import requests

headers = {
    'Authorization': 'Bearer TU_API_KEY',
    'Content-Type': 'application/json'
}

res = requests.post('https://TU_SERVIDOR/api/whatsapp/enviar',
    headers=headers,
    json={
        'numero': '573001234567',
        'tipo': 'text',
        'mensaje': 'Hola, este es un mensaje de prueba'
    }
)

print(res.json())
# {'success': True, 'message': 'Mensaje enviado correctamente'}
Imagen
res = requests.post('https://TU_SERVIDOR/api/whatsapp/enviar',
    headers=headers,
    json={
        'numero': '573001234567',
        'tipo': 'image',
        'url': 'https://ejemplo.com/imagen.jpg',
        'caption': 'Mira esta imagen'
    }
)
Ubicaci贸n
res = requests.post('https://TU_SERVIDOR/api/whatsapp/enviar',
    headers=headers,
    json={
        'numero': '573001234567',
        'tipo': 'location',
        'latitud': 4.7110,
        'longitud': -74.0086,
        'nombre': 'Bogot谩, Colombia'
    }
)
Texto
 true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer TU_API_KEY',
        'Content-Type: application/json'
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'numero' => '573001234567',
        'tipo'   => 'text',
        'mensaje'=> 'Hola, este es un mensaje de prueba'
    ])
]);

$res = json_decode(curl_exec($ch), true);
// ['success' => true, 'message' => 'Mensaje enviado correctamente']
?>
Imagen
 '573001234567',
    'tipo'    => 'image',
    'url'     => 'https://ejemplo.com/imagen.jpg',
    'caption' => 'Mira esta imagen'
]));
?>
Texto
curl -X POST https://TU_SERVIDOR/api/whatsapp/enviar \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"numero":"573001234567","tipo":"text","mensaje":"Hola mundo"}'
Imagen
curl -X POST https://TU_SERVIDOR/api/whatsapp/enviar \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"numero":"573001234567","tipo":"image","url":"https://ejemplo.com/img.jpg","caption":"Texto"}'
Documento
curl -X POST https://TU_SERVIDOR/api/whatsapp/enviar \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"numero":"573001234567","tipo":"document","url":"https://ejemplo.com/doc.pdf"}'
Ubicaci贸n
curl -X POST https://TU_SERVIDOR/api/whatsapp/enviar \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"numero":"573001234567","tipo":"location","latitud":4.7110,"longitud":-74.0086,"nombre":"Bogot谩"}'
Respuesta
{ "success": true, "message": "Mensaje enviado correctamente" }
C贸digos de Error
C贸digo Significado
401API Key inv谩lida o no enviada
400WhatsApp no est谩 conectado o par谩metros incorrectos
429L铆mite de mensajes diarios alcanzado
500Error interno del servidor
驴Necesitas ayuda? Escr铆benos a soporte@innovaapi.com