Maytapi
Maytapi/Documentație//catalog
/catalogPentru numere WhatsApp BusinessAPI WhatsApp pentru catalogul de produse
Gestionează catalogul de produse al numărului tău WhatsApp Business din propriul sistem. Adaugă produse și colecții, trimite un produs sau tot catalogul într-o conversație și primește comenzile clienților fără să ieși din cod.
- produse și colecții
- mesaje de produs
- mesaje de catalog
- comenzi pe webhook
Catalogul tău, gestionat prin API
Ține catalogul WhatsApp sincronizat cu magazinul tău în loc să-l editezi manual în aplicație.
-
catalog/addProduct
Adaugă și editează produse
Creează produse cu nume, descriere, preț, imagine, link și retailer id; editează-le sau ascunde-le ulterior.
-
catalog/getProducts
Listează produsele
Citește toate produsele din catalog sau un singur produs după id.
-
catalog/addCollection
Colecții
Grupează produsele în colecții și adaugă sau scoate produse din ele.
-
type: product
Mesaje de produs
Trimite cardul unui produs în conversație, ca clientul să-l vadă și să-l comande.
-
type: catalog
Mesaje de catalog
Distribuie tot catalogul cu titlu și descriere într-un singur mesaj.
-
catalog/getOrders
Comenzi
Comenzile plasate din catalog ajung la webhook; cele recente pot fi listate și prin API.
Sincronizează produsele din magazin
Trimite produsele din sistemul de e-commerce în catalogul WhatsApp, câte o cerere pentru fiecare. Actualizează prețurile sau ascunde produsele epuizate la fel.
- ✓Nume, descriere, preț și imagine
- ✓Link de produs și propriul retailer id
- ✓Ascunde un produs fără să-l ștergi
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/catalog/addProduct" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "Classic sneaker",
"description": "Canvas sneaker, sizes 38–45",
"price": "49.90",
"imageUrl": "https://example.com/sneaker.jpg",
"url": "https://example.com/sneaker",
"retailerId": "SKU-1042",
"isHidden": false
}'curl "https://api.maytapi.com/api/$PID/$PHONE_ID/catalog/getProducts" \ -H "x-maytapi-key: $TOKEN"
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/catalog/getCollections" \ -H "x-maytapi-key: $TOKEN"
Trimite un produs sau tot catalogul
Când un client întreabă, răspunde cu cardul produsului sau cu tot catalogul — ambele se deschid nativ în WhatsApp.
- ✓type: product cu id-ul produsului
- ✓type: catalog cu titlu și descriere opționale
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": "product",
"productId": "3121315354601301"
}'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": "catalog",
"message": "Check out our products!",
"title": "Our catalog",
"description": "New arrivals every week"
}'Primește comenzile pe webhook
Când un client trimite o comandă din catalog, aceasta ajunge la webhook ca orice alt mesaj. Salveaz-o în propria bază de date — getOrders păstrează doar comenzile primite cât timp sesiunea rulează.
- ✓Comenzile ajung în timp real
- ✓getOrders și getOrders/{orderId} pentru comenzi recente
- ✓Păstrează comenzile în sistemul tău pentru istoric
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/catalog/getOrders" \ -H "x-maytapi-key: $TOKEN"
curl "https://api.maytapi.com/api/$PID/$PHONE_ID/catalog/getOrders/$ORDER_ID" \ -H "x-maytapi-key: $TOKEN"
Cine folosește API-ul de catalog
-
Magazine online
Ține catalogul WhatsApp identic cu magazinul web, inclusiv prețurile.
-
Echipe de vânzări
Răspunde la întrebări despre produse cu cardul produsului în loc de un mesaj lung.
-
Agenții și SaaS
Gestionează cataloagele pentru multe numere de clienți dintr-o singură platformă.
Întrebări frecvente despre catalogul de produse
Întreabă echipa de suport orice pe WhatsApp. Timpul mediu de răspuns este sub 24 de ore.
Centru de ajutor →Am nevoie de un cont WhatsApp Business?
Da. Catalogul este o funcție WhatsApp Business, deci numărul conectat trebuie să fie un număr WhatsApp Business.
Stochează Maytapi comenzile?
Comenzile ajung la webhook în timp real. getOrders returnează doar comenzile primite cât timp sesiunea rulează, așa că salvează-le în propria bază de date pentru un istoric permanent.
Pot trimite un singur produs într-o conversație?
Da. Trimite un mesaj cu type product și id-ul produsului; clientul vede cardul nativ al produsului.
Pot grupa produsele?
Da. Creează colecții și adaugă sau scoate produse prin API.
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.