Maytapi
Maytapi/Documentație//sendMessage
/sendMessageOrice tip de fișier, un singur endpointAPI WhatsApp pentru mesaje media
Trimite imagini, video, GIF-uri, documente PDF, Excel și Word, audio și stickere de pe propriul număr WhatsApp sau pune o fotografie deasupra unui mesaj cu butoane. Un singur endpoint sendMessage: dai un URL sau base64, iar tipul fișierului este detectat automat.
- imagini, video și GIF
- PDF, Excel și Word
- fișiere de până la 50MB
- media în butoane
Orice fișier pe care îl poate trimite WhatsApp
Același endpoint și aceleași headere pentru fiecare tip — se schimbă doar câmpul type și câteva opțiuni.
-
type: media
Imagini
Imagini JPG, PNG și WebP cu descriere opțională. Folosește isHd pentru fotografii mai clare acolo unde WhatsApp permite.
-
type: media
Video
Videoclipuri MP4 cu descriere, redate direct în conversație. Folosește type: shortVideo pentru o notă video rotundă.
-
isGif: true
GIF-uri
Trimite un MP4 scurt cu isGif, iar WhatsApp îl redă în buclă ca pe un GIF.
-
type: media + filename
PDF, Excel și Word
Facturi, liste de prețuri și rapoarte ca fișiere PDF, XLSX sau DOCX, cu numele de fișier pe care îl vede clientul.
-
type: media
Audio
Trimite fișiere audio OGG (Opus) și MP3 prin URL sau base64.
-
type: sticker
Stickere
Trimite un sticker WebP la fel ca o imagine.
Trimite orice fișier prin URL sau base64
Pune un URL public în câmpul message sau trimite fișierul ca base64. Adaugă o descriere cu text și activează isHd pentru imagini mai clare.
- ✓Imagini, video și audio prin URL sau base64
- ✓Descriere la fiecare mesaj media
- ✓Fișiere de până la 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": "4072xxxxx67@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": "4072xxxxx67@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": "4072xxxxx67@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": "4072xxxxx67@c.us",
"type": "media",
"message": "https://example.com/welcome.ogg"
}'Fișiere PDF, Excel și Word cu numele tău
Trimite facturi, liste de prețuri și rapoarte ca documente. Cu filename, clientul vede factura-10482.pdf în loc de un nume aleatoriu.
- ✓PDF, XLSX, DOCX și alte documente
- ✓Nume de fișier și descriere personalizate
- ✓Funcționează în conversații, grupuri și canale
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": "4072xxxxx67@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": "4072xxxxx67@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": "4072xxxxx67@c.us",
"type": "media",
"message": "https://example.com/files/contract.docx",
"filename": "service-agreement.docx"
}'GIF-uri, stickere și note video
Adaugă isGif la un MP4 scurt și WhatsApp îl redă în buclă ca pe un GIF. Stickerele pleacă ca fișiere WebP, iar shortVideo trimite o notă video rotundă.
- ✓isGif: true pentru GIF-uri în buclă
- ✓Stickere WebP și note video rotunde
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": "4072xxxxx67@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": "4072xxxxx67@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": "4072xxxxx67@c.us",
"type": "shortVideo",
"message": "https://example.com/hello.mp4"
}'Pune o fotografie deasupra unui mesaj cu butoane
Mesajele cu butoane acceptă și câmpul media: arată fotografia unui produs, a unui colet sau un banner promoțional deasupra butoanelor Urmărește comanda sau Cumpără.
- ✓Câmpul media în mesajele buttons
- ✓Butoane de răspuns, URL, apel și copiere cod
- ✓Titlu și subsol opționale în jurul conținutului
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": "4072xxxxx67@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": "4072xxxxx67@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"
}
]
}'Ce trimit echipele prin API-ul media
-
Facturi și chitanțe
Trimite factura sau chitanța PDF direct pe WhatsApp-ul clientului după comandă.
-
Liste de prețuri
Trimite lista de prețuri a lunii ca fișier Excel sau PDF distribuitorilor și clienților en-gros.
-
Suport cu capturi
Trimite imagini explicative, video scurte și mesaje vocale din helpdesk.
-
Fotografii de produs cu butoane
Arată fotografia unui produs cu butoanele Cumpără și Detalii când un client întreabă de el.
-
Videoclipuri și GIF-uri promoționale
Anunță o reducere într-o comunitate sau pe un canal cu un video scurt sau un GIF în buclă.
-
Rapoarte pentru clienți
Trimite rapoarte zilnice sau săptămânale ca documente pe numărul fiecărui client.
Întrebări frecvente despre mesajele media
Întreabă echipa de suport orice pe WhatsApp. Timpul mediu de răspuns este sub 24 de ore.
Centru de ajutor →Cât de mare poate fi un fișier?
Prin sendMessage se pot trimite fișiere de până la 50MB. Videoclipurile foarte mari pot dura totuși mai mult până se încarcă pe WhatsApp.
Pot trimite un fișier fără să-l găzduiesc?
Da. Trimite fișierul ca data URL base64 în câmpul message în loc de un link public.
Am nevoie de aprobarea șabloanelor pentru media?
Nu. Maytapi trimite de pe propriul tău număr prin WhatsApp Web, așa că imaginile, video-urile, documentele și orice alt tip media pleacă fără verificarea șabloanelor de către Meta.
Pot trimite media în grupuri și canale?
Da. Folosește id-ul grupului sau al canalului ca to_number; canalele acceptă și imagini, video, documente, GIF-uri și stickere.
Alte funcționalități ale API-ului WhatsApp
Obține cheia și trimite primul mesaj în zece minute
Fără aprobare, fără șabloane, fără card. Toate endpointurile sunt deschise timp de trei zile.