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. Místo směrování každého klienta manuálním procesem registrace zahájíte registraci jejich jménem, přesměrujete je do SmsManagerem hostovaného toku, kde dokončí registraci WhatsApp Business Account (WABA), a poté použijete management endpointy k dohledaní detailů jejich účtu po dokončení onboardingu. 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žadavkux-api-key.
Onboardingový tok
- POST /whatsapp/signup — Odešlete detaily vašeho klienta SmsManageru. Obdržíte
redirect_urla krátkodobý JWTtoken. - 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. - Klient dokončí registraci — Klient sleduje kroky registrace WhatsApp Business v hostovaném toku SmsManageru. Žádné kódování na jeho straně není nutné.
- Přijme 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í. - Získejte WABA ID — Zavolejte
POST /whatsapp/accounts/listpro získáníwhatsapp_id(WABA ID) nového účtu. - Spravujte telefonní čísla a šablony — Použijte WABA ID s
POST /whatsapp/phone_numbers/listaPOST /whatsapp/templates/listk získání zdrojů potřebných k odesílání zpráv.
Souhrn endpointů
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.