Maytapi
Maytapi/Documentação//sendMessage
/sendMessageTodos os tipos de arquivo, um endpointAPI de mensagens de mídia do WhatsApp
Envie imagens, vídeo, GIF, documentos PDF, Excel e Word, áudio e figurinhas do seu próprio número de WhatsApp, ou coloque uma foto acima de uma mensagem com botões. Um único endpoint sendMessage: passe uma URL ou base64 e o tipo de arquivo é detectado automaticamente.
- imagens, vídeo e GIF
- PDF, Excel e Word
- arquivos de até 50MB
- mídia em botões
Todo arquivo que o WhatsApp consegue enviar
O mesmo endpoint e os mesmos headers para todos os tipos — só mudam o campo type e algumas opções.
-
type: media
Imagens
Imagens JPG, PNG e WebP com legenda opcional. Use isHd para enviar fotos mais nítidas onde o WhatsApp permite.
-
type: media
Vídeo
Vídeos MP4 com legenda que tocam dentro da conversa. Use type: shortVideo para uma nota de vídeo redonda.
-
isGif: true
GIF
Envie um MP4 curto com isGif e o WhatsApp o reproduz em loop como um GIF.
-
type: media + filename
PDF, Excel e Word
Faturas, listas de preços e relatórios em PDF, XLSX ou DOCX, com o nome de arquivo que o cliente vê.
-
type: media
Áudio
Envie arquivos de áudio OGG (Opus) e MP3 por URL ou base64.
-
type: sticker
Figurinhas
Envie uma figurinha WebP do mesmo jeito que uma imagem.
Envie qualquer arquivo por URL ou base64
Aponte o campo message para uma URL pública ou envie o arquivo em base64. Adicione uma legenda com text e ative isHd para imagens mais nítidas.
- ✓Imagens, vídeo e áudio por URL ou base64
- ✓Legenda em toda mensagem de mídia
- ✓Arquivos de até 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": "55119xxxxxx67@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": "55119xxxxxx67@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": "55119xxxxxx67@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": "55119xxxxxx67@c.us",
"type": "media",
"message": "https://example.com/welcome.ogg"
}'Arquivos PDF, Excel e Word com o seu próprio nome
Envie faturas, listas de preços e relatórios como documentos. Com filename o cliente vê fatura-10482.pdf em vez de um nome aleatório.
- ✓PDF, XLSX, DOCX e outros documentos
- ✓Nome de arquivo e legenda personalizados
- ✓Funciona em conversas, grupos e canais
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": "55119xxxxxx67@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": "55119xxxxxx67@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": "55119xxxxxx67@c.us",
"type": "media",
"message": "https://example.com/files/contract.docx",
"filename": "service-agreement.docx"
}'GIF, figurinhas e notas de vídeo
Adicione isGif a um MP4 curto e o WhatsApp o reproduz em loop como um GIF. Figurinhas vão como WebP e shortVideo envia uma nota de vídeo redonda.
- ✓isGif: true para GIF em loop
- ✓Figurinhas WebP e 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": "55119xxxxxx67@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": "55119xxxxxx67@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": "55119xxxxxx67@c.us",
"type": "shortVideo",
"message": "https://example.com/hello.mp4"
}'Coloque uma foto acima de uma mensagem com botões
Mensagens com botões também aceitam o campo media: mostre a foto de um produto, de uma encomenda ou um banner de promoção acima dos botões Rastrear pedido ou Comprar.
- ✓Campo media em mensagens buttons
- ✓Botões de resposta, URL, ligação e copiar código
- ✓Título e rodapé opcionais ao redor da mídia
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": "55119xxxxxx67@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": "55119xxxxxx67@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"
}
]
}'O que as equipes enviam com a API de mídia
-
Notas fiscais e recibos
Envie a nota ou o recibo em PDF direto para o WhatsApp do cliente após a compra.
-
Listas de preços
Envie a lista de preços do mês em Excel ou PDF para revendedores e clientes atacadistas.
-
Suporte com prints
Envie imagens explicativas, vídeos curtos e áudios pelo seu helpdesk.
-
Fotos de produto com botões
Mostre a foto de um produto com os botões Comprar e Detalhes quando um cliente perguntar por ele.
-
Vídeos e GIF promocionais
Anuncie uma promoção em uma comunidade ou canal com um vídeo curto ou um GIF em loop.
-
Relatórios para clientes
Entregue relatórios diários ou semanais como documentos no número de cada cliente.
Perguntas frequentes sobre mensagens de mídia
Pergunte o que quiser ao nosso suporte pelo WhatsApp. O tempo médio de resposta é inferior a 24 horas.
Central de ajuda →Qual o tamanho máximo de um arquivo?
É possível enviar arquivos de até 50MB com sendMessage. Vídeos muito grandes ainda podem demorar mais para subir ao WhatsApp.
Posso enviar um arquivo sem hospedá-lo?
Sim. Envie o arquivo como data URL em base64 no campo message em vez de um link público.
Preciso de aprovação de templates para enviar mídia?
Não. A Maytapi envia do seu próprio número pelo WhatsApp Web, então imagens, vídeo, documentos e qualquer outro tipo de mídia saem sem revisão de modelos da Meta.
Posso enviar mídia para grupos e canais?
Sim. Use o id do grupo ou do canal como to_number; os canais também aceitam imagens, vídeo, documentos, GIF e figurinhas.
Pegue sua chave e envie a primeira mensagem em dez minutos
Sem aprovação, sem templates, sem cartão. Todos os endpoints liberados por três dias.