Catalogues et commandes

Le module le plus vaste : 61 routes couvrant le commerce natif de WhatsApp, où le client parcourt un catalogue et commande sans quitter la conversation.

Catalogues

GET    /whatsapp/catalogs
POST   /whatsapp/catalogs
GET    /whatsapp/catalogs/{id}
PATCH  /whatsapp/catalogs/{id}
DELETE /whatsapp/catalogs/{id}
POST   /whatsapp/catalogs/connect
POST   /whatsapp/catalogs/{id}/sync

sync pousse l'ensemble du catalogue Fiitsa vers Meta. Il rend la main dès la mise en file : Meta traite ensuite de son côté, et /diagnostics puis /errors disent ce qui a été refusé.

Produits

GET  /whatsapp/catalogs/{id}/products
POST /whatsapp/catalogs/{id}/products/batch
GET  /whatsapp/catalogs/{id}/products/batch/{handle}
GET  /whatsapp/products/{id}
GET  /whatsapp/products/{id}/errors

Passe par batch dès que tu dépasses quelques produits : un appel unitaire par article épuise le quota Meta et prend des minutes là où un lot prend des secondes. Le handle renvoyé permet ensuite de suivre le traitement.

Commandes

GET   /whatsapp/orders
GET   /whatsapp/orders/{id}
GET   /whatsapp/orders/{id}/items
PATCH /whatsapp/orders/{id}/items
GET   /whatsapp/orders/{id}/payments
POST  /whatsapp/orders/{id}/acknowledge
POST  /whatsapp/orders/acknowledge-batch

Accuser réception n'est pas facultatif. Une commande non acquittée reste affichée « en attente » chez le client, et Meta pénalise les marchands qui laissent traîner. Fais-le dès la réception, avant même de préparer.

Passe une idempotency_key sur les écritures : un accusé rejoué ne créera pas de doublon.

Retours, remboursements, annulations

GET  /whatsapp/returns
POST /whatsapp/orders/{id}/returns
GET  /whatsapp/returns/{id}
PATCH /whatsapp/returns/{id}
GET  /whatsapp/orders/{id}/refunds
POST /whatsapp/orders/{id}/refunds
GET  /whatsapp/orders/{id}/refundable-amount
GET  /whatsapp/orders/{id}/cancellations
POST /whatsapp/orders/{id}/cancellations

Interroge refundable-amount avant de rembourser : le montant remboursable tient compte des remboursements déjà passés, et un dépassement est refusé par Meta.

Expéditions

GET   /whatsapp/orders/{id}/shipments
POST  /whatsapp/orders/{id}/shipments
PATCH /whatsapp/orders/{id}/shipments/{shipmentId}

Flux produits et profils de livraison

GET/POST   /whatsapp/catalogs/{id}/feeds
GET/PATCH/DELETE /whatsapp/feeds/{id}
GET/POST   /whatsapp/feeds/{id}/uploads
GET/POST   /whatsapp/shipping-profiles
PATCH/DELETE /whatsapp/shipping-profiles/{id}

Réglages

GET   /whatsapp/commerce/settings
PATCH /whatsapp/commerce/settings
GET   /whatsapp/commerce/eligibility

eligibility dit si le compte remplit les conditions du commerce WhatsApp. À interroger avant de construire une intégration de vente : les conditions varient selon les pays.