Skip to main content

Resumen de API

La API de Whaapy te permite enviar mensajes de WhatsApp de forma programática. Está diseñada para ser compatible con Meta WhatsApp Cloud API mientras ofrece shortcuts que simplifican casos de uso comunes.

Base URL

Todas las rutas documentadas son relativas a esta URL base.

Autenticación

Todas las requests requieren un header Authorization con tu API Key:
Ver Autenticación para más detalles.

Formato Híbrido

Nuestra API acepta dos estilos de request, dándote flexibilidad para usar el formato que prefieras:
Formato simplificado para casos comunes:
El estilo Whaapy es más corto y fácil de usar. El estilo Meta es útil si ya tienes código funcionando con la API oficial de WhatsApp.

Endpoints Disponibles

Mensajes

Media


Tipos de Mensaje Soportados

text

Texto simple

image

JPEG, PNG, WebP

video

MP4 hasta 16MB

audio

MP3, OGG, AAC

document

PDF, Word, Excel

sticker

WebP hasta 500KB

template

Pre-aprobados por Meta

interactive

Botones y listas

location

Coordenadas GPS

contacts

Tarjetas vCard

reaction

Emojis en mensajes

Códigos de Respuesta HTTP

Ver Códigos de Error para errores específicos de WhatsApp.

Rate Limits

Los rate limits pueden variar según tu plan. Contacta soporte para límites personalizados.

Límites de Tamaño de Media


Ventana de 24 Horas

WhatsApp tiene una regla de ventana de 24 horas: solo puedes enviar mensajes de texto libre a usuarios que te han escrito en las últimas 24 horas.
Dentro de la ventana (24h desde último mensaje del usuario):
  • Puedes enviar cualquier tipo de mensaje
  • Texto, imágenes, videos, interactivos, etc.
Fuera de la ventana (>24h sin respuesta):
  • Solo puedes enviar template messages pre-aprobados por Meta
  • Ver Enviar Templates

Estructura de Respuesta Exitosa

Todas las respuestas exitosas siguen esta estructura:

Estructura de Respuesta de Error

Ver Códigos de Error para la lista completa.

SDKs y Ejemplos

Actualmente no tenemos SDKs oficiales, pero la API es simple de usar con cualquier cliente HTTP:

Próximos Pasos

Autenticación

Configura tu API Key

Enviar Mensaje

Envía tu primer mensaje

Templates

Mensajes fuera de ventana 24h

Códigos de Error

Manejo de errores