Monen asiakkaan sosiaalisen median API: yksi API-avain, monta asiakkaan tiliä
easyCoexistencen Partner API on suunniteltu usealle asiakkaalle alusta alkaen: yksi ec_live_-avain tililläsi yhdistää ja hallinnoi monien asiakkaiden WhatsApp-numeroita ja some-tilejä. Jokaisella yhteydellä on asiakkaasi tunnus external_ref-kenttänä, oma token ja oma webhook-osoite, ja se näkyy allekirjoitetuissa tilatapahtumissa. GET /channels?external_ref= listaa yhden asiakkaan tilit.
Pisin external_ref, jonka yhteysistunto hyväksyy: oman tunnuksesi asiakkaalle, tallentuu luotuun yhteyteen.
API-avainta, joita easyCoexistence-tilillä voi olla kerrallaan. Erilliset avaimet tarkoittavat erillisiä tilejä ja erillisiä laskuja.
Yhteysistuntoa, jotka tilillä voi olla auki samaan aikaan, ja raja 100 uudelle istunnolle tunnissa.
Ikä, jonka jälkeen allekirjoitetun tapahtuman aikaleima hylätään; HMAC verrataan vakioajassa.
Miten yksi tili palvelee monia asiakkaita?
easyCoexistence-tilisi edustaa tuotettasi, ja jokainen asiakas on merkintä niissä yhteyksissä, jotka hän tuo. Asiakkaat eivät luo omaa tiliä eivätkä näe avaintasi, ja laskutat heitä itse, et easyCoexistence:
Miten merkitset jokaisen yhteyden asiakkaaseen?
Lähetä external_ref yhteysistunnossa. Arvo tallennetaan numeroon tai kanavaan, jonka istunto luo, lisätään uudelleenohjaukseen ja sisällytetään sen tilatapahtumiin. Facebook- tai LinkedIn-kirjautuminen, joka tuo useita sivuja, merkitsee jokaisen niistä. Yhden asiakkaan tilit näet suodattamalla kumman tahansa listan:
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"Miten asiakkaiden tokenit pidetään erillään?
Jokainen yhteys pitää omaa asiakastaan vastaavan tokenin. WhatsApp-numeron token on Metan Embedded Signupissa myöntämä yritystoken, rajattu tuon asiakkaan resursseihin, ja sometilin token on se, minkä sen omistaja myönsi. Tunnistetiedot tulevat vain sinun avaimellasi, backendistäsi, ja tunnus, joka ei kuulu tilillesi, vastaa 404 not_found. Hae asiakkaan yhteys, johon työ kuuluu, ennen tokenin noutamista, jotta yhden asiakkaan työ ei koskaan aja toisen tilillä.
Miten webhookit toimivat asiakaskohtaisesti?
Yksi kohde per tili, jonka valitset sinä. Osoita kanavat yhteen URL-osoitteeseen ja ohjaa account_id:n perusteella rungosta, tai anna jokaiselle asiakkaalle oma URL-osoite. Jokainen kanava allekirjoittaa omalla salaisuudellaan, joka asetetaan PUT /channels/{id}/webhook-kutsulla, joten account_id kertoo, millä salaisuudella tarkistaa. Numeron viestit kulkevat Metalta sen webhook_url-osoitteeseen, joka asetetaan WhatsApp Business -tilille, joten ohjaa ne phone_number_id:n perusteella.
Miten tilatapahtumat kertovat, mistä asiakkaasta ne ovat?
Kantamalla external_ref-tunnustasi. Yksi tapahtumien URL-osoite per tili vastaanottaa connection.* ja channel.* -tapahtumat, joista kukin sisältää yhteys- tai kanavanäkymän external_ref mukaan lukien, ja post.published ja post.failed kantavat julkaisun ja sen kanavan. Tapahtumat allekirjoitetaan tilin omalla salaisuudella otsikossa X-EC-Signature, ja ne yritetään uudelleen, kun endpointisi epäonnistuu, joten käsittele jokainen toimitustunnus kerran.
Kuinka nopeasti voit ottaa käyttöön monta asiakasta?
50 avointa yhteysistuntoa ja 100 uutta tunnissa per tili. Meta laskee jokaisen ensimmäisen kerran tehtävän WhatsApp-käyttöönoton koko sovellusta koskevaan rajaan, jonka kaikki easyCoexistence-tilit jakavat, ja rajat estävät yhden alustan tuonnin kuluttamasta sitä. Luo jokainen istunto juuri silloin, kun sen asiakas on yhdistämässä, ja raja vastaa 429 cap_reached tai rate_limited -virheellä.
Mitä tehdään, jos asiakkaan tili on jo yhdistetty muualle?
Kirjautuminen hylätään. Sometili yhdistyy kerrallaan yhden easyCoexistence-tilin kautta, joten jos toinen easyCoexistencea käyttävä palvelu pitää sitä hallussaan, istunnon last_error kertoo sen ja asiakas poistaa tilin siellä tai kirjautuu eri tilillä. Omalla tililläsi asiakas voi yhdistää niin monta tiliä kuin tarvitsee, jokainen merkittynä samalla external_ref-tunnuksella.
Miten poistat yhden asiakkaan käytöstä?
Listaa hänen yhteytensä ja kanavansa external_ref-tunnuksella ja poista jokainen DELETE-pyynnöllä. Numeron poistaminen peruu easyCoexistencen käyttöoikeuden Metalla ja lopettaa valvonnan; kanavan poistaminen peruu käyttöoikeuden verkostossa ja poistaa jonossa vielä odottavat julkaisut. Laskutus jokaiselle päättyy jakson lopussa, ja asiakkaan muut yhteydet, kuten muidenkin asiakkaiden, pysyvät koskemattomina.
Yleiset virheet
- Sähköpostin käyttäminen external_ref-arvona. Sähköpostit vaihtuvat, ja arvo tallennetaan jokaiseen yhteyteen, joten käytä oman tietokantasi pysyvää tunnusta.
- Edelleenlähetettyjen tapahtumien tarkistaminen väärän asiakkaan salaisuudella. Hae salaisuus rungon account_id:n perusteella, koska jokainen kanava allekirjoittaa omallaan.
- Yhteyslinkkien lähettäminen koko asiakaskunnalle kerralla. Tilillä voi olla auki vain 50 istuntoa, joten kutsu asiakkaat erissä.
- Asiakkaan poistaminen vain omasta tietokannasta. Hänen yhteytensä jäävät tilillesi ja laskuusi, kunnes jokainen poistetaan API:n kautta.
easyCoexistence antaa yhden API-avaimen palvella koko asiakaskuntaasi: heidän WhatsApp-numeronsa sekä Instagram-, Facebook-, TikTok-, YouTube- ja LinkedIn-tilinsä ja muita kanavia. Jokainen on merkitty asiakastunnuksellasi ja sillä on oma token, webhook ja allekirjoitetut tapahtumat, ja jokaista yhteyttä valvotaan ympäri vuorokauden. US$ 9:stä US$ 0,75:een per yhteys kuukaudessa, hinta laskee yhteyksien lisääntyessä, ensimmäiset 3 päivää ilmaiseksi.
Usein kysytyt kysymykset
Tarvitsenko yhden easyCoexistence-tilin per asiakas?
Ei. Yksi tili ja sen avain voivat pitää monen asiakkaan yhteydet, jotka erotetaan external_ref-tunnuksella. Erillisiä tilejä tarvitaan vain, jos haluat erilliset laskut.
Voivatko asiakkaat nähdä toistensa tilit?
Eivät easyCoexistencen kautta. He eivät koskaan pidä avaintasi, ja he avaavat vain omat yhdistämislinkkinsä. Se, mitä kukin asiakas näkee tuotteessasi, päätetään sinun koodillasi.
Voinko antaa jokaiselle asiakkaalle eri webhook-URL:n?
Kyllä. Jokainen numero ja jokainen kanava saa oman kohteensa, joten asiakaskohtainen URL-osoite toimii, samoin yksi yhteinen URL-osoite, joka ohjataan account_id:n perusteella.
Miten monen asiakkaan tili laskutetaan?
Yhteyskohtaisesti, kaikkien asiakkaidesi yhteydet yhdessä laskettuna: US$ 9:stä US$ 0,75:een per yhteys kuukaudessa, hinnan määräytyessä kokonaismäärän kaistasta. 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