Nou Safe Mode încălzește numerele noi pentru a reduce riscul de blocare pe WhatsApp. Află mai multe →

Maytapi/Documentație//interactive

/interactiveFără aprobare de șabloane

API 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
Butoane și liste interactive WhatsApp
Tipuri de mesaje

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

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
Un mesaj WhatsApp cu fotografie, titlu, subsol și patru butoane de răspuns trimis prin API Maytapi
Liste

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
Un mesaj listă WhatsApp cu meniul de opțiuni deschis, trimis prin API Maytapi
Caruseluri

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
Un carusel WhatsApp cu carduri de produse glisabile și butoane, trimis prin API Maytapi
Cerere

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"
      }
    ]
  }'
Cazuri de utilizare

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

Î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.

Începe să folosești API-ul 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.