Maytapi
Maytapi/Documentación//sendMessage
/sendMessageTodos los tipos de archivo, un endpointAPI de mensajes multimedia de WhatsApp
Envía imágenes, vídeo, GIF, documentos PDF, Excel y Word, audio y stickers desde tu propio número de WhatsApp, o pon una foto encima de un mensaje con botones. Un solo endpoint sendMessage: pasa una URL o base64 y el tipo de archivo se detecta solo.
- imágenes, vídeo y GIF
- PDF, Excel y Word
- archivos de hasta 50MB
- multimedia en botones
Todos los archivos que WhatsApp puede enviar
El mismo endpoint y las mismas cabeceras para cada tipo; solo cambian el campo type y algunas opciones.
-
type: media
Imágenes
Imágenes JPG, PNG y WebP con un pie opcional. Usa isHd para enviar fotos más nítidas donde WhatsApp lo permite.
-
type: media
Vídeo
Vídeos MP4 con pie que se reproducen dentro del chat. Usa type: shortVideo para una nota de vídeo redonda.
-
isGif: true
GIF
Envía un MP4 corto con isGif y WhatsApp lo reproduce en bucle como un GIF.
-
type: media + filename
PDF, Excel y Word
Facturas, listas de precios e informes en PDF, XLSX o DOCX, con el nombre de archivo que verá tu cliente.
-
type: media
Audio
Envía archivos de audio OGG (Opus) y MP3 desde una URL o en base64.
-
type: sticker
Stickers
Envía un sticker WebP igual que una imagen.
Envía cualquier archivo por URL o base64
Pon una URL pública en el campo message o pasa el archivo en base64. Añade un pie con text y activa isHd para imágenes más nítidas.
- ✓Imágenes, vídeo y audio por URL o base64
- ✓Un pie en cada mensaje multimedia
- ✓Archivos de hasta 50MB
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "3461xxxxx67@c.us",
"type": "media",
"message": "https://example.com/new-arrival.jpg",
"text": "New arrival: classic sneaker, $59",
"isHd": true
}'curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "3461xxxxx67@c.us",
"type": "media",
"message": "https://example.com/unboxing.mp4",
"text": "How to set up your order"
}'curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "3461xxxxx67@c.us",
"type": "media",
"message": "data:image/png;base64,iVBORw0KG...",
"text": "Screenshot"
}'curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "3461xxxxx67@c.us",
"type": "media",
"message": "https://example.com/welcome.ogg"
}'Archivos PDF, Excel y Word con tu propio nombre
Envía facturas, listas de precios e informes como documentos. Con filename el cliente ve factura-10482.pdf en lugar de un nombre aleatorio.
- ✓PDF, XLSX, DOCX y otros documentos
- ✓Nombre de archivo y pie personalizados
- ✓Funciona en chats, grupos y canales
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "3461xxxxx67@c.us",
"type": "media",
"message": "https://example.com/files/inv-10482.pdf",
"filename": "invoice-10482.pdf",
"text": "Your invoice for order #10482"
}'curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "3461xxxxx67@c.us",
"type": "media",
"message": "https://example.com/files/prices-oct.xlsx",
"filename": "price-list-october.xlsx",
"text": "This month’s price list"
}'curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "3461xxxxx67@c.us",
"type": "media",
"message": "https://example.com/files/contract.docx",
"filename": "service-agreement.docx"
}'GIF, stickers y notas de vídeo
Añade isGif a un MP4 corto y WhatsApp lo reproduce en bucle como un GIF. Los stickers se envían como WebP y shortVideo envía una nota de vídeo redonda.
- ✓isGif: true para GIF en bucle
- ✓Stickers WebP y notas de vídeo redondas
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "3461xxxxx67@c.us",
"type": "media",
"message": "https://example.com/sale.mp4",
"text": "Weekend sale starts now",
"isGif": true
}'curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "3461xxxxx67@c.us",
"type": "sticker",
"message": "https://example.com/thanks.webp"
}'curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "3461xxxxx67@c.us",
"type": "shortVideo",
"message": "https://example.com/hello.mp4"
}'Pon una foto encima de un mensaje con botones
Los mensajes con botones también aceptan el campo media: muestra la foto de un producto, de un paquete o un banner de promoción sobre los botones Seguir pedido o Comprar.
- ✓Campo media en mensajes buttons
- ✓Botones de respuesta, URL, llamada y copiar código
- ✓Título y pie opcionales alrededor del contenido
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "3461xxxxx67@c.us",
"type": "buttons",
"message": "Classic sneaker, sizes 38–45",
"media": "https://example.com/sneaker.jpg",
"buttons": [
{
"id": "buy",
"text": "Buy now"
},
{
"id": "sizes",
"text": "See sizes"
}
]
}'curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/sendMessage" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"to_number": "3461xxxxx67@c.us",
"type": "buttons",
"message": "10% off your next order",
"title": "Thank you!",
"footer": "Valid until Sunday",
"media": "https://example.com/banner.jpg",
"buttons": [
{
"url": "https://example.com/shop",
"text": "Open the shop"
},
{
"code": "THANKS10",
"text": "Copy code"
}
]
}'Qué envían los equipos con la API multimedia
-
Facturas y recibos
Envía la factura o el recibo en PDF directamente al WhatsApp del cliente tras la compra.
-
Listas de precios
Envía la lista de precios del mes en Excel o PDF a distribuidores y clientes mayoristas.
-
Soporte con capturas
Envía imágenes explicativas, vídeos cortos y notas de voz desde tu helpdesk.
-
Fotos de producto con botones
Muestra la foto de un producto con los botones Comprar y Detalles cuando un cliente pregunta por él.
-
Vídeos y GIF promocionales
Anuncia una oferta en una comunidad o un canal con un vídeo corto o un GIF en bucle.
-
Informes para clientes
Entrega informes diarios o semanales como documentos al número de cada cliente.
Preguntas frecuentes sobre mensajes multimedia
Pregunta lo que quieras a nuestro equipo de soporte por WhatsApp. El tiempo medio de respuesta es inferior a 24 horas.
Centro de ayuda →¿Qué tamaño puede tener un archivo?
Con sendMessage se pueden enviar archivos de hasta 50MB. Los vídeos muy grandes pueden tardar más en subirse a WhatsApp.
¿Puedo enviar un archivo sin alojarlo?
Sí. Envía el archivo como data URL en base64 en el campo message en lugar de un enlace público.
¿Necesito aprobación de plantillas para enviar multimedia?
No. Maytapi envía desde tu propio número a través de WhatsApp Web, así que imágenes, vídeo, documentos y cualquier otro tipo multimedia salen sin revisión de plantillas de Meta.
¿Puedo enviar multimedia a grupos y canales?
Sí. Usa el id del grupo o del canal como to_number; los canales también aceptan imágenes, vídeo, documentos, GIF y stickers.
Más funciones de la API de WhatsApp
Consigue tu clave y envía tu primer mensaje en diez minutos
Sin aprobación, sin plantillas, sin tarjeta. Todos los endpoints abiertos durante tres días.