Skip to main content
WhatsApp Business Partner API SmsManageru vám dává programový způsob, jak registrovat vaše klienty pro WhatsApp Business messaging, sledovat jejich pokrok při onboardingu a poté kompletně spravovat jejich WhatsApp Business účty — získávat telefonní čísla, řídit celý životní cyklus šablon zpráv a číst analytiku zpráv — vše pod vašimi partnerskými přihlašovacími údaji.

​
Pro koho je toto API?

Pokud jste ISV, reseller nebo tvůrce platformy integrující WhatsApp messaging do produktu, který nabízíte vlastním zákazníkům, toto API je pro vás. Zahájíte registraci jménem klienta, přesměrujete jej do SmsManagerem hostovaného toku (nebo onboarding dokončíte programově), kde zaregistruje svůj WhatsApp Business Account (WABA), a poté použijete management endpointy k jeho správě. API již není určeno pouze pro onboarding. Kromě registrace a dohledání účtu nyní pokrývá také:
  • Správu šablon zpráv — vytváření šablon, jejich vytváření z knihovny Meta Template Library, úpravu, mazání a odesílání ostrých testovacích zpráv.
  • Analytiku — analytiku zpráv (odesláno / doručeno), analytiku konverzací (počty a náklady) a výkonnost jednotlivých šablon (odesláno, doručeno, přečteno, kliknuto).
Všechno běží pod vaším partnerským účtem — vaši klienti nikdy nepotřebují přímý přístup k SmsManageru.

​
Základní URL

​
Autentizace

Všechny endpointy vyžadují váš API klíč v hlavičce požadavku x-api-key.
Několik management endpointů (telefonní čísla, šablony, analytika) přijímá jako alternativní autentizaci také krátkodobý token v těle požadavku — tentýž registrační token vrácený z POST /whatsapp/signup (platný 1 hodinu). Použijte jej, když tato volání řídíte z hostovaného registračního toku místo svého API klíče.

​
Onboardingový tok

  1. POST /whatsapp/signup — Odešlete detaily vašeho klienta SmsManageru. Obdržíte redirect_url a krátkodobý JWT token.
  2. Přesměrujte klienta — Přidejte token jako query parametr a pošlete prohlížeč klienta na redirect_url?token=<JWT>. SmsManager slouží hostovanou registrační UI.
  3. Klient dokončí registraci — Klient sleduje kroky registrace WhatsApp Business v hostovaném toku SmsManageru. Žádné kódování na jeho straně není nutné.
  4. Dokončení registrace — Onboarding lze dokončit také programově pomocí POST /whatsapp/registration, které vymění Meta OAuth code, připojí WABA a zaregistruje telefonní číslo.
  5. Přijměte callback — SmsManager POSTuje oznámení o stavu onboardingu na partner_callback_url, které jste zadali v kroku 1. Poslouchejte na událost dokončení.
  6. Získejte WABA ID — Zavolejte POST /whatsapp/accounts/list pro získání whatsapp_id (WABA ID) nového účtu.
  7. Spravujte telefonní čísla a šablony — Použijte WABA ID s POST /whatsapp/phone_numbers/list a POST /whatsapp/templates/list k získání zdrojů potřebných k odesílání zpráv.
Režim phone_number, který při registraci požadujete, je nyní jeden z manual (klient připojí vlastní číslo), preassign (číslo z našeho poolu je předpřiřazeno) nebo assigned (použije se již přiřazené číslo). Původní hodnota automatic byla odstraněna.

​
Souhrn endpointů

​
WhatsApp účty

​
Telefonní čísla

​
Šablony zpráv

​
Analytika

Jednotlivé endpointy — s parametry, těly požadavků a příklady — najdete v postranním panelu této sekce. Jsou generovány přímo z OpenAPI specifikace.