API social media dla wielu klientów: jeden klucz API, wiele kont klientów
Partner API easyCoexistence jest z założenia wielodostępne (multi-tenant): jeden klucz ec_live_ na Twoim koncie łączy i zarządza numerami WhatsApp oraz kontami social media wielu klientów. Każde połączenie niesie identyfikator klienta jako external_ref, przechowuje własny token tego klienta, ma osobny adres webhooka i pojawia się w podpisanych zdarzeniach statusu, więc GET /channels?external_ref= zwraca konta jednego klienta.
Najdłuższa wartość external_ref, jaką przyjmuje sesja łączenia: własny identyfikator klienta, zapisany w połączeniu, które sesja tworzy.
Klucze API, które jedno konto easyCoexistence może mieć naraz; osobne klucze oznaczają osobne konta z osobnymi rachunkami.
Sesje łączenia, które jedno konto może mieć otwarte jednocześnie, obok limitu 100 nowych sesji na godzinę.
Wiek, po którym odrzuca się znacznik czasu podpisanego zdarzenia, a HMAC porównuje się w stałym czasie.
Jak jedno konto obsługuje wielu klientów?
Twoje konto easyCoexistence reprezentuje Twój produkt, a każdy klient to znacznik przypisany do połączeń, które wnosi. Klienci nie zakładają własnego konta, nigdy nie widzą Twojego klucza i są rozliczani przez Ciebie, a nie przez easyCoexistence:
Jak oznaczać każde połączenie swoim klientem?
Wyślij external_ref w sesji łączenia. Wartość jest zapisywana na numerze lub kanale, który sesja tworzy, dodawana do przekierowania i uwzględniana w jej zdarzeniach statusu. Logowanie przez Facebooka lub LinkedIn, które przynosi kilka Stron, oznacza każdą z nich. Aby zobaczyć konta jednego klienta, filtruj którąkolwiek z list:
curl "https://easycoexistence.com/api/v1/channels?external_ref=customer_4821" \
-H "Authorization: Bearer $EC_API_KEY"
curl "https://easycoexistence.com/api/v1/connections?external_ref=customer_4821" \
-H "Authorization: Bearer $EC_API_KEY"Jak utrzymywać tokeny klientów osobno?
Każde połączenie przechowuje token swojego klienta. Token numeru WhatsApp to token biznesowy, który Meta wydaje w Embedded Signup, ograniczony do zasobów tego klienta, a token konta social media to ten, który przyznał jego właściciel. Dane uwierzytelniające przychodzą wyłącznie przez Twój klucz, z Twojego backendu, a identyfikator, którego nie ma na Twoim koncie, zwraca 404 not_found. Zanim pobierzesz token, wyszukaj połączenie klienta, do którego należy zadanie, aby praca jednego najemcy nigdy nie działała na koncie innego.
Jak działają webhooki dla każdego klienta?
Jeden adres docelowy na konto, wybrany przez Ciebie. Skieruj kanały na jeden URL i rozdzielaj według account_id w treści albo daj każdemu klientowi osobny URL. Każdy kanał podpisuje własnym sekretem z PUT /channels/{id}/webhook, więc account_id wskazuje, którym sekretem zweryfikować podpis. Wiadomości z numeru idą od Meta na jego webhook_url, ustawiony w WhatsApp Business Account, więc rozdzielaj je według phone_number_id.
Skąd zdarzenia statusu wiedzą, którego klienta dotyczą?
Niosą Twój external_ref. Jeden URL zdarzeń na konto odbiera zdarzenia connection.* i channel.*, każde z widokiem połączenia lub kanału w środku, z external_ref włącznie, a post.published i post.failed niosą post i jego kanał. Zdarzenia są podpisywane sekretem konta w nagłówku X-EC-Signature i ponawiane, gdy Twój endpoint zawiedzie, więc obsłuż każdy identyfikator dostarczenia tylko raz.
Jak szybko wdrożyć wielu klientów?
Limity wynoszą 50 otwartych sesji łączenia i 100 nowych na godzinę na konto. Meta liczy każde pierwsze wdrożenie WhatsApp względem limitu na poziomie aplikacji, który dzielą wszystkie konta easyCoexistence, a limity chronią przed tym, by import jednej platformy go wyczerpał. Twórz sesję, gdy jej klient jest tuż przed połączeniem. Przekroczony limit zwraca 429 cap_reached lub rate_limited.
Co, jeśli konto klienta jest już połączone gdzie indziej?
Logowanie zostaje odrzucone. Konto social media łączy się przez jedno konto easyCoexistence naraz, więc jeśli inna usługa korzystająca z easyCoexistence je trzyma, last_error w sesji to mówi, a klient usuwa je tam albo loguje się innym kontem. W Twoim koncie klient może połączyć tyle kont, ile potrzebuje, każde oznaczone tym samym external_ref.
Jak odłączyć jednego klienta?
Wylistuj jego połączenia i kanały według external_ref i wykonaj DELETE dla każdego. Usunięcie numeru odbiera easyCoexistence dostęp u Meta i zatrzymuje monitorowanie; usunięcie kanału odbiera dostęp w sieci społecznościowej i anuluje jego posty wciąż czekające w kolejce. Rozliczanie każdego kończy się z końcem cyklu, a pozostałe połączenia klienta, jak i innych najemców, pozostają nietknięte.
Typowe błędy
- Używanie e-maila jako external_ref. E-maile się zmieniają, a wartość jest zapisywana w każdym połączeniu, więc użyj stabilnego identyfikatora z własnej bazy danych.
- Weryfikowanie przekazanych zdarzeń sekretem niewłaściwego najemcy. Wyszukaj sekret po account_id w treści, bo każdy kanał podpisuje własnym.
- Wysyłanie linków do łączenia całej bazie klientów naraz. Na konto może być otwartych tylko 50 sesji, więc zapraszaj klientów falami.
- Usuwanie klienta tylko we własnej bazie danych. Jego połączenia pozostają na Twoim koncie i na Twoim rachunku, dopóki każde nie zostanie usunięte przez API.
easyCoexistence pozwala jednemu kluczowi API obsługiwać całą bazę klientów: ich numery WhatsApp oraz konta Instagram, Facebook, TikTok, YouTube i LinkedIn, a także kolejne kanały, każde oznaczone identyfikatorem klienta, z własnym tokenem, webhookiem i podpisanymi zdarzeniami, a każde połączenie jest monitorowane 24/7. Od US$ 9 do US$ 0,75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z pierwszymi 3 dniami za darmo.
Najczęściej zadawane pytania
Czy potrzebuję osobnego konta easyCoexistence dla każdego klienta?
Nie. Jedno konto i jego klucz mogą obsługiwać połączenia wielu klientów, rozróżniane przez external_ref. Osobne konta są potrzebne tylko wtedy, gdy chcesz osobne rachunki.
Czy moi klienci mogą widzieć swoje wzajemne konta?
Nie przez easyCoexistence. Nigdy nie posiadają Twojego klucza i otwierają wyłącznie własne linki do łączenia. To, co każdy klient widzi w Twoim produkcie, decyduje Twój kod.
Czy mogę podać każdemu klientowi inny URL webhooka?
Tak. Każdy numer i każdy kanał przyjmuje własny adres docelowy, więc URL dla konkretnego klienta działa, tak samo jak jeden wspólny URL rozdzielany według account_id.
Jak rozliczane jest konto wielu najemców?
Za połączenia łącznie u wszystkich klientów: od US$ 9 do US$ 0,75 za połączenie miesięcznie, zależnie od przedziału łącznej liczby, z pierwszymi 3 dniami za darmo.
Czytaj dalej
Połącz pierwszy kanał w dwie minuty.
Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.
- 3 dni za darmo
- Rezygnacja w każdej chwili
- Tylko oficjalne API
- Monitorowanie 24/7
Zweryfikowano w