Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

API mediów społecznościowych dla agencji: prowadź konta klientów z własnego oprogramowania

API mediów społecznościowych dla agencji pozwala oprogramowaniu agencji łączyć, publikować, odpowiadać i raportować na kontach każdego klienta. Dzięki Partner API easyCoexistence numer WhatsApp klienta oraz jego konta Instagram, Facebook, TikTok, YouTube i LinkedIn dołączają do konta agencji przez hostowane linki oznaczone id klienta, a jeden klucz API planuje, kieruje i monitoruje je wszystkie.

200 characters

Najdłuższy external_ref, jaki przyjmuje sesja łączenia: własne id klienta agencji, zachowywane przy każdym połączeniu.

1 hour

Jak długo hostowany link do połączenia działa dla klienta, który go otworzy.

Advanced Access

Czego potrzebuje aplikacja Meta, by obsługiwać profesjonalne konta Instagram, których nie posiada ani nie zarządza, po App Review i Business Verification.

ADMINISTRATOR

Rola na stronie LinkedIn potrzebna członkowi do uprawnienia rw_organization_admin, które zarządza stronami i odczytuje ich raporty.

End of cycle

Kiedy kończy się rozliczanie za połączenie klienta, które agencja usuwa przez API.

Jak API organizuje klientów agencji?

Według Twojego id klienta. Przekaż je jako external_ref w każdej sesji łączenia; zostaje ono przy każdym numerze i koncie utworzonym przez sesję i wraca w każdym zdarzeniu statusu. GET /channels?external_ref=client_118 wyświetla konta w mediach społecznościowych tego klienta, a &channel=instagram zawęża wynik do jednej sieci; GET /connections?external_ref=client_118 wyświetla jego numery WhatsApp. Każdy klient znajduje się na jednym koncie agencji, pod jednym kluczem ec_live_, dzięki czemu cała liczba mieści się w jednym przedziale cenowym.

One client's accounts
curl "https://easycoexistence.com/api/v1/channels?external_ref=client_118" \
  -H "Authorization: Bearer $EC_API_KEY"

curl "https://easycoexistence.com/api/v1/connections?external_ref=client_118" \
  -H "Authorization: Bearer $EC_API_KEY"

Jak klient przekazuje dostęp?

Przez link, który wysyła agencja. POST /connect-sessions z siecią jako channel, external_ref klienta i nazwą agencji jako partner_name zwraca url; klient go otwiera, loguje się na ekranie zgody danej sieci albo uruchamia okno Meta i skanuje kod QR dla numeru WhatsApp, po czym wraca na redirect_url agencji. Logowanie przez Facebook lub LinkedIn może przynieść kilka stron naraz, każda jako osobne połączenie, więc sprawdź listę z briefem klienta.

Jak agencja publikuje dla klientów?

Z własnego procesu akceptacji. Oprogramowanie agencji trzyma szkice, aż klient je zatwierdzi, a następnie wysyła każdy zatwierdzony post do POST /channels/:id/posts z jego publish_at, nawet z wyprzedzeniem do 90 dni. GET /channels/:id/posts podaje kalendarz jednego konta, GET /posts z filtrem statusu pokazuje, co czeka we wszystkich klientach, a post.published i post.failed informują opiekuna klienta, co się wydarzyło. Posty na LinkedIn zawsze wymagają zatwierdzenia przez osobę, a krok akceptacji agencji już to zapewnia.

Jak agencja odpowiada na komentarze i wiadomości prywatne klientów?

Z jednej skrzynki, która kieruje według konta. PUT /channels/:id/webhook ustawia miejsce docelowe dla każdego konta Instagram, strony Facebook i konta TikTok, a każdy przekazany komentarz, wzmianka lub wiadomość prywatna niesie account_id, które wskazuje klienta. Wiadomości z numeru WhatsApp przechodzą od Meta na webhook_url ustawiony dla tego numeru. Odpowiedzi wychodzą przez API każdej sieci z danymi uwierzytelniającymi z GET /channels/:id?credentials=1, a zespół agencji może też pracować na wielu klientach w Claude lub ChatGPT przez łącznik MCP na tym samym koncie.

Jak agencja buduje raporty dla klientów?

Z analityki każdej sieci, wywoływanej danymi uwierzytelniającymi konta klienta. Statystyki Instagrama i Facebooka pochodzą z Meta Graph API, TikToka z API for Business, YouTube z YouTube Analytics, którego adres bazowy zawierają dane uwierzytelniające, a LinkedIn z jego endpointów statystyk. Zadanie raportowe agencji pobiera świeże dane uwierzytelniające dla każdego konta na początku przebiegu, pobiera dane za dany okres i zapisuje je pod external_ref klienta.

Skąd agencja wie, że konto klienta wymaga uwagi?

Z podpisanych zdarzeń statusu. channel.disconnected i connection.disconnected niosą external_ref klienta, więc oprogramowanie agencji może zaalarmować opiekuna tego klienta i wysłać klientowi nowy link do połączenia. Każde połączenie jest monitorowane całą dobę, a właściciel agencji dostaje też e-mail, gdy któreś się rozłącza. Klient, który w ustawieniach sieci cofnie dostęp, pojawia się w ten sam sposób.

Co się dzieje w API, gdy klient odchodzi?

Zadanie offboardingu agencji wyświetla połączenia klienta według external_ref i wywołuje DELETE /channels/:id oraz DELETE /connections/:id dla każdego z nich. Rozliczenie za nie ustaje z końcem cyklu, zaplanowane posty na usuniętym kanale są anulowane, a token usuniętego konta w mediach społecznościowych zostaje usunięty. Numer WhatsApp pozostaje w Cloud API, dopóki klient go nie odłączy w aplikacji WhatsApp Business.

Typowe błędy

  • Ustawianie postów klienta w kolejce przed jego akceptacją. Post w kolejce zostaje opublikowany o swojej porze bez kolejnej kontroli, więc trzymaj szkice w kroku akceptacji i wysyłaj je dopiero po zatwierdzeniu.
  • Wstawianie klucza Partner API do strony front-end portalu klienta. Klucz daje dostęp do danych uwierzytelniających każdego klienta na koncie, więc trzymaj go na serwerze agencji.
  • Oczekiwanie na zdarzenia komentarzy z kanału YouTube klienta lub ze strony LinkedIn. easyCoexistence nie otrzymuje ich z żadnego z nich, więc zadanie raportu lub skrzynki odczytuje je przez API każdej sieci.
Z EasyCoexistence zrobisz to

easyCoexistence daje oprogramowaniu agencji jedno API dla numerów WhatsApp klientów oraz ich kont Instagram, Facebook, TikTok, YouTube i LinkedIn, a także kolejne kanały, które dołączają do tego samego API: hostowane linki do połączenia oznaczane per klient, kolejkę publikacji, przekazywane komentarze i wiadomości prywatne, świeże dane uwierzytelniające do raportów oraz monitorowanie każdego połączenia całą dobę. Od US$ 9 do US$ 0.75 za połączenie miesięcznie, spadając wraz z dodawaniem połączeń, z pierwszymi 3 dniami bezpłatnie.

Najczęściej zadawane pytania

Czy klienci potrzebują własnego konta easyCoexistence?

Nie. Klient otwiera hostowany link i się loguje, a połączenie dołącza do konta agencji, gdzie jest rozliczane i monitorowane.

Czy agencja może trzymać klientów pod osobnymi kluczami API?

Jedno konto ma jeden klucz. Osobne klucze oznaczają osobne konta easyCoexistence, każde rozliczane od pierwszego przedziału, dlatego większość agencji rozdziela klientów przez external_ref.

Czy klient widzi nazwę agencji podczas łączenia?

Tak. Hostowana strona pokazuje nazwę przesłaną jako partner_name. Ekran zgody danej sieci wskazuje easyCoexistence jako aplikację prosząca o dostęp.

Ile kosztuje easyCoexistence dla agencji?

Od US$ 9 do US$ 0.75 za połączenie klienta miesięcznie, spadając wraz z dodawaniem klientów, tak samo w każdej sieci, z pierwszymi 3 dniami bezpłatnie.

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