Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

Sosiaalisen median API toimistoille: hallinnoi asiakkaidesi tilejä omasta ohjelmistostasi

Sosiaalisen median API toimistoille antaa toimiston omalle ohjelmistolle mahdollisuuden yhdistää, julkaista, vastata ja raportoida kunkin asiakkaan tileillä. easyCoexistencen Partner API:n kautta asiakkaan WhatsApp-numero sekä Instagram-, Facebook-, TikTok-, YouTube- ja LinkedIn-tilit liittyvät toimiston tiliin hostattujen linkkien kautta, jotka on merkitty asiakkaan tunnuksella. Yksi API-avain ajastaa, reitittää ja valvoo kaikkia niitä.

200 characters

Pisin external_ref-arvo, jonka yhteysistunto hyväksyy: toimiston oma tunnus asiakkaalle, joka tallennetaan jokaiseen yhteyteen.

1 hour

Kuinka kauan asiakkaalle avattu hostattu yhteyslinkki on voimassa.

Advanced Access

Mitä Meta-sovellus tarvitsee palvellakseen Instagram-ammattitilejä, joita se ei omista eikä hallinnoi, App Reviewn ja Business Verificationin jälkeen.

ADMINISTRATOR

LinkedIn-sivun rooli, jota jäsen tarvitsee rw_organization_admin-oikeuteen; oikeus hallinnoi sivuja ja lukee niiden raportointia.

End of cycle

Milloin laskutus lakkaa asiakasyhteydeltä, jonka toimisto poistaa API:n kautta.

Miten API järjestää toimiston asiakkaat?

Asiakastunnuksesi mukaan. Lähetä se external_ref-kenttänä jokaiseen yhteysistuntoon, ja se jää jokaiseen istunnon luomaan numeroon ja tiliin ja palaa jokaisessa tilatapahtumassa. GET /channels?external_ref=client_118 listaa kyseisen asiakkaan sosiaalisen median tilit, &channel=instagram rajaa yhteen verkkoon, ja GET /connections?external_ref=client_118 listaa heidän WhatsApp-numeronsa. Jokainen asiakas on toimiston yhdellä tilillä, yhden ec_live_-avaimen alla, mikä pitää koko määrän yhdessä hintaluokassa.

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"

Miten asiakas antaa käyttöoikeuden?

Toimiston lähettämän linkin kautta. POST /connect-sessions, jossa channel-kenttänä on verkko, external_ref on asiakkaan ja partner_name on toimiston nimi, palauttaa url-osoitteen. Asiakas avaa sen, kirjautuu sisään verkon omalla suostumusnäkymällä tai avaa Metan ponnahdusikkunan ja skannaa QR-koodin WhatsApp-numerolle, ja päätyy toimiston redirect_url-osoitteeseen. Facebook- tai LinkedIn-kirjautuminen voi tuoda useita sivuja kerralla, joista kukin on oma yhteytensä, joten tarkista lista asiakkaan toimeksiannon mukaan.

Miten toimisto julkaisee asiakkaiden puolesta?

Omasta hyväksymisprosessistaan. Toimiston ohjelmisto pitää luonnokset, kunnes asiakas hyväksyy ne, ja lähettää sitten jokaisen hyväksytyn julkaisun POST /channels/:id/posts -kutsulla publish_at-ajan kanssa, enintään 90 päivää eteenpäin. GET /channels/:id/posts antaa yhden tilin kalenterin, GET /posts status-suodattimella näyttää, mikä odottaa eri asiakkailla, ja post.published sekä post.failed kertovat tilinhoitajalle, mitä tapahtui. LinkedIn-julkaisut kulkevat aina henkilön hyväksynnän kautta, minkä toimiston hyväksyntävaihe jo tarjoaa.

Miten toimisto vastaa asiakkaiden kommentteihin ja viesteihin?

Yhdestä postilaatikosta, joka reitittää tilin mukaan. PUT /channels/:id/webhook asettaa kohteen jokaiselle Instagram-tilille, Facebook-sivulle ja TikTok-tilille, ja jokainen välitetty kommentti, maininta tai viesti kantaa account_id-kentän, joka vastaa asiakasta. WhatsApp-numeron viestit kulkevat Metalta sille asetettuun webhook_url-osoitteeseen. Vastaukset lähtevät kunkin verkon API:n kautta GET /channels/:id?credentials=1 -kutsun tunnistetiedoilla, ja toimiston tiimi voi myös työskennellä asiakkaiden yli Claudessa tai ChatGPT:ssä saman tilin MCP-liittimen kautta.

Miten toimisto rakentaa asiakasraportit?

Kunkin verkon omasta analytiikasta, kutsuttuna asiakkaan tilin tunnistetiedoilla. Instagramin ja Facebookin tiedot tulevat Metan Graph API:sta, TikTokin tiedot sen API for Business -rajapinnasta, YouTuben tiedot YouTube Analyticsista, jonka perusosoite on tunnistetiedoissa, ja LinkedInin tiedot sen tilastopäätepisteistä. Toimiston raporttiajo hakee tuoreet tunnistetiedot kullekin tilille jokaisen ajon alussa, hakee kauden luvut ja tallentaa ne asiakkaan external_ref-tunnisteen alle.

Miten toimisto tietää, että asiakkaan tili vaatii huomiota?

Allekirjoitetuista tilatapahtumista. channel.disconnected ja connection.disconnected kantavat asiakkaan external_ref-tunnisteen, joten toimiston ohjelmisto voi hälyttää kyseisen asiakkaan tilinhoitajan ja lähettää asiakkaalle uuden yhteyslinkin. Jokaista yhteyttä valvotaan 24/7, ja toimiston omistajalle lähetetään myös sähköposti, kun yhteys katkeaa. Asiakas, joka peruu käyttöoikeuden verkon asetuksista, näkyy samalla tavalla.

Mitä API tekee, kun asiakas lähtee?

Toimiston irtisanomistehtävä listaa asiakkaan yhteydet external_ref-tunnisteella ja kutsuu jokaiselle DELETE /channels/:id ja DELETE /connections/:id. Niiden laskutus päättyy kierron lopussa, poistetulle kanavalle ajastetut julkaisut peruutetaan, ja poistetun sosiaalisen median tilin tokenin unohdetaan. WhatsApp-numero pysyy Cloud API:ssa, kunnes asiakas irrottaa sen WhatsApp Business -sovelluksessa.

Yleiset virheet

  • Asiakkaan julkaisujen jonottaminen ennen asiakkaan hyväksyntää. Jonotettu julkaisu julkaistaan aikanaan ilman uutta tarkistusta, joten pidä luonnokset hyväksyntävaiheessasi ja lähetä ne vasta, kun ne on hyväksytty.
  • Partner API -avaimen laittaminen asiakasportaalin etupäähän. Avain ulottuu kaikkiin asiakkaiden tunnistetietoihin tilillä, joten pidä se toimiston palvelimella.
  • Asiakkaan YouTube-kanavan tai LinkedIn-sivun kommenttitapahtumien odottaminen. easyCoexistence ei vastaanota niitä kummastakaan, joten raportti- tai postilaatikkotyö lukee ne kunkin verkon API:sta.
Näin teet tämän EasyCoexistencen avulla

easyCoexistence antaa toimiston omalle ohjelmistolle yhden API:n asiakkaidensa WhatsApp-numeroille sekä Instagram-, Facebook-, TikTok-, YouTube- ja LinkedIn-tileille, ja lisää kanavia on tulossa: asiakaskohtaisesti merkityt hostatut yhteyslinkit, julkaisujono, välitetyt kommentit ja viestit, tuoreet tunnistetiedot raportteihin ja jokainen yhteys valvottuna 24/7. US$ 9:stä US$ 0,75:een per yhteys kuukaudessa, hinta laskee yhteyksien lisääntyessä, ensimmäiset 3 päivää ilmaiseksi.

Usein kysytyt kysymykset

Tarvitsevatko asiakkaat oman easyCoexistence-tilin?

Eivät. Asiakas avaa hostatun linkin ja kirjautuu sisään, ja yhteys liittyy toimiston tiliin, jossa se laskutetaan ja valvotaan.

Voiko toimisto pitää asiakkaat eri API-avaimilla?

Yhdellä tilillä on yksi avain. Erilliset avaimet tarkoittavat erillisiä easyCoexistence-tilejä, joista kukin laskutetaan ensimmäisestä hintaluokasta alkaen, joten useimmat toimistot erottavat asiakkaat external_ref-tunnisteella.

Näkeekö asiakas toimiston nimen yhdistäessään?

Näkee. Hostattu sivu näyttää partner_name-kentän nimen. Verkon oma suostumusnäkymä nimeää easyCoexistencen sovelluksena, joka pyytää käyttöoikeutta.

Paljonko easyCoexistence maksaa toimistolle?

US$ 9:stä US$ 0,75:een asiakasyhteydeltä kuukaudessa, hinta laskee toimiston lisätessä asiakkaita, sama kaikissa verkoissa, ensimmäiset 3 päivää ilmaiseksi.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu