Maytapi/Documentație//interactive
/interactiveFără aprobare de șabloaneAPI WhatsApp pentru mesaje interactive
Trimite butoane de răspuns, butoane de link și de apel, meniuri tip listă și caruseluri de produse de pe propriul număr WhatsApp. Un singur endpoint sendMessage, fără aprobare de șabloane — alegerea clientului revine la webhookul tău.
- butoane de răspuns
- butoane de link și apel
- mesaje tip listă
- caruseluri

Toate formatele interactive într-un endpoint
Alegi câmpul type și tipul butonului; restul cererii rămâne la fel.
-
buttons · id
Butoane de răspuns
Răspunsuri rapide precum Confirmă sau Anulează. Id-ul butonului revine ca să știi ce s-a ales.
-
buttons · url
Butoane de link
Deschide o pagină de urmărire, un link de plată sau site-ul tău cu o atingere.
-
buttons · phoneNumber
Butoane de apel
Clientul sună la suport direct din mesaj.
-
buttons · code
Butoane de copiere cod
Trimite un cupon sau un cod de verificare pe care clientul îl copiază cu o atingere.
-
type: list
Mesaje tip listă
Un buton de meniu care deschide secțiuni și rânduri — ideal pentru meniuri de suport și intervale de programare.
-
type: carousel
Caruseluri
Până la 10 carduri glisabile, fiecare cu media și până la 5 butoane, pentru produse și oferte.
Butoane cu media, titlu și subsol
Adaugă o imagine sau un video, un titlu, corpul și un subsol, apoi combină butoane de răspuns, link, apel și copiere cod în același mesaj.
- ✓Butoanele de răspuns trimit id-ul la webhook
- ✓Butoanele de link și apel nu cer configurare suplimentară
- ✓Butoane de copiere cod pentru cupoane și coduri unice
Meniuri tip listă pentru multe opțiuni
Când trei butoane nu ajung, trimite o listă. Clientul o deschide cu textul butonului tău și alege un rând din secțiuni.
- ✓Grupează rândurile în secțiuni cu titlu
- ✓Fiecare rând are titlu, descriere și rowId
- ✓Ideal pentru meniuri de suport, sucursale și intervale orare
Carduri de produs glisabile
Arată mai multe produse sau oferte unul lângă altul. Fiecare card are propria imagine, text și butoane.
- ✓Până la 10 carduri per carusel
- ✓Până la 5 butoane per card
- ✓Media este obligatorie pe fiecare card
Același endpoint, alt type
Butoanele, listele și caruselurile se trimit toate cu POST /sendMessage. Se schimbă doar câmpul type și opțiunile lui.
- ✓Funcționează din cURL, Node.js, Python, PHP și orice client HTTP
- ✓Fără revizuirea șabloanelor, trimiți imediat
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",
"title": "Your order #10482",
"message": "Your order is ready to ship. Please confirm the delivery address.",
"footer": "Maytapi Store",
"media": "https://example.com/order.jpg",
"buttons": [
{
"id": "confirm",
"text": "Confirm"
},
{
"url": "https://example.com/track/10482",
"text": "Track order"
},
{
"phoneNumber": "4072xxxxx67",
"text": "Call us"
}
]
}'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": "Here is 10% off your next order.",
"buttons": [
{
"code": "WELCOME10",
"text": "Copy code"
}
]
}'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": "list",
"title": "How can we help?",
"message": "Choose a topic and we will connect you to the right team.",
"footer": "Support",
"button_text": "See options",
"sections": [
{
"title": "Support topics",
"rows": [
{
"rowId": "status",
"title": "Order status",
"description": "Track a recent order"
},
{
"rowId": "returns",
"title": "Returns",
"description": "Start a return or exchange"
}
]
}
]
}'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": "carousel",
"message": "New arrivals this week",
"cards": [
{
"title": "Classic sneaker",
"body": "Sizes 38–45",
"media": "https://example.com/sneaker.jpg",
"buttons": [
{
"id": "add_sneaker",
"text": "Add to cart"
},
{
"url": "https://example.com/sneaker",
"text": "Details"
}
]
},
{
"title": "Canvas backpack",
"body": "Free shipping",
"media": "https://example.com/backpack.jpg",
"buttons": [
{
"id": "add_backpack",
"text": "Add to cart"
},
{
"url": "https://example.com/backpack",
"text": "Details"
}
]
}
]
}'Unde funcționează cel mai bine mesajele interactive
-
Confirmarea comenzilor
Confirmă, modifică sau anulează o comandă cu o atingere în loc de un răspuns scris.
-
Mementouri pentru programări
Trimite un memento cu butoanele Confirmă și Reprogramează și actualizează calendarul din webhook.
-
Meniuri de suport
Direcționează clientul către echipa potrivită cu un mesaj tip listă înainte să intervină un agent.
-
Vitrină de produse
Prezintă produsele noi într-un carusel cu butoane de adăugare în coș și detalii.
-
Cupoane și coduri
Trimite coduri de reducere sau de verificare cu un buton de copiere cod.
-
Fluxuri de chatbot
Ghidează conversațiile botului cu butoane, ca răspunsurile să rămână structurate.
Întrebări frecvente despre mesajele interactive
Întreabă echipa de suport orice pe WhatsApp. Timpul mediu de răspuns este sub 24 de ore.
Centru de ajutor →Am nevoie de aprobarea șabloanelor pentru a trimite butoane?
Nu. Maytapi trimite mesajele interactive de pe propriul tău număr prin WhatsApp Web, deci nu există revizuirea șabloanelor de către Meta. Le poți trimite imediat.
Ce tipuri de butoane sunt suportate?
Butoane de răspuns cu id, de link cu url, de apel cu phoneNumber și de copiere cod cu code. Titlul, subsolul și media sunt opționale.
Câte carduri poate avea un carusel?
Până la 10 carduri per carusel. Fiecare card are nevoie de media și acceptă până la 5 butoane.
Cum aflu ce buton a apăsat clientul?
Alegerea clientului ajunge la webhook ca orice mesaj primit, astfel încât codul tău poate reacționa imediat.
Pot adăuga o imagine la un mesaj cu butoane?
Da. Adaugă o adresă media în cerere, iar imaginea sau videoclipul apare deasupra textului mesajului.
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.