Asiakkaiden API-tokenien hakeminen WhatsAppille, Instagramille ja TikTokille
easyCoexistencen Partner API palauttaa yhdistetyn asiakkaan API-tokenin ja tunnukset yhdellä GET-pyynnöllä parametrilla ?credentials=1. WhatsApp-numeron kohdalla /connections/{id} antaa waba_id:n, phone_number_id:n, Graph API -perusosoitteen, lähetyspäätepisteen ja asiakkaan oman yritystokenin. Sosiaalisen median tilin kohdalla /channels/{id} antaa verkon API-perusosoitteen, tilin tunnuksen siellä ja sinulle uusitun access-tokenin, joten hae se jokaisen työn alussa.
Lisää credentials-tiedot kohtaan GET /connections/{id} WhatsApp-numeroille ja kohtaan GET /channels/{id} somekanaville.
Google-käyttäjän access-tokenin elinikä, eli tyyppi, jota YouTube-kanavan API-kutsut käyttävät.
TikTok-tilin access-tokenin voimassaoloaika API for Business -rajapinnasta; sen refresh-token on voimassa yhden vuoden.
Kuinka kauan uudistettu pitkäikäinen Instagram-token pysyy voimassa, laskettuna uudistuspäivästä.
Metan pitkäikäisillä Page-tokeneilla ei ole vanhenemispäivää, mutta tietyt ehdot voivat mitätöidä ne.
Mikä kutsu palauttaa yhteyden tunnistetiedot?
Resurssin oma GET ?credentials=1 -parametrilla, todennettuna ec_live_-avaimellasi bearer-tokenina. WhatsApp-numero on osoitteessa /connections/{id} ja sometili osoitteessa /channels/{id}, ja kummallakin on oma tunnusavaruutensa: yhdistämisen uudelleenohjaus antaa sinulle connection_id:n numerolle ja channel_id:n sometilille. GET /connections ja GET /channels listaavat ne, ja ?external_ref= rajaa kummankin listan yhteen asiakkaaseen. Ilman parametria samat kutsut palauttavat yhteyden ilman tokenia.
# A WhatsApp number
curl "https://easycoexistence.com/api/v1/connections/$CONNECTION_ID?credentials=1" \
-H "Authorization: Bearer $EC_API_KEY"
# A social account
curl "https://easycoexistence.com/api/v1/channels/$CHANNEL_ID?credentials=1" \
-H "Authorization: Bearer $EC_API_KEY"Mitä WhatsApp-numeron credentials-kutsu palauttaa?
Yhteyden itsensä sekä credentials-objektin. waba_id ja phone_number_id tunnistavat WhatsApp Business -tilin ja numeron Metan Graph API:ssa, ja token_ready kertoo, onko asiakkaan token tallessa. credentials-objektin sisällä graph_api_base ja send_endpoint sisältävät jo Graph API -version, ja access_token on Metan asiakkaan yhdistäessä myöntämä yritystoken, rajattu juuri siihen asiakkaaseen. Taustajärjestelmäsi kutsuu sitten Metaa suoraan lähettääkseen viestejä, hallitakseen viestipohjia, lataamalla mediaa ja muokatakseen yritysprofiilia.
- status: connected, degraded, disconnected, banned, suspended, removed tai unknown.
quality_ratingjamessaging_tier: Metan arvio, esimerkiksi GREEN, ja numeron taso, esimerkiksiTIER_1K.webhook_url: URL-osoite, johon Meta lähettää numeron viestit, tai null.disconnected_reason,last_checked_at,last_event_atjacreated_at: Metan katkaisusyy, jos sellainen on kirjattu, sekä ISO 8601 -aikaleimat.
{
"id": "<CONNECTION_ID>",
"external_ref": "customer_4821",
"connect_session_id": "cs_…",
"phone": "+55 11 9…",
"name": "Clínica Sorriso",
"waba_id": "<WABA_ID>",
"phone_number_id": "<PHONE_NUMBER_ID>",
"status": "connected",
"quality_rating": "GREEN",
"messaging_tier": "TIER_1K",
"platform_type": "…",
"token_ready": true,
"webhook_url": "https://hooks.example.com/wa/<long-random-secret>",
"disconnected_reason": null,
"last_checked_at": "2026-10-31T09:00:00.000Z",
"last_event_at": "2026-10-31T08:41:12.000Z",
"created_at": "2026-10-20T14:03:55.000Z",
"credentials": {
"graph_api_base": "https://graph.facebook.com/v25.0",
"send_endpoint": "https://graph.facebook.com/v25.0/<PHONE_NUMBER_ID>/messages",
"access_token": "EAAG…",
"note": "The customer's own business token, scoped to their assets. …"
}
}Mitä kunkin verkon credentials-kutsu palauttaa?
Kanavan tiedot samassa muodossa kuin GET /channels/{id}: kentät id, channel, external_ref, name, username, external_id, status ja token_ready, sekä credentials-objekti. Jokaisen verkon credentials-objektissa on platform, API-perusosoite, tilin tunnus kyseisessä verkossa, access_token, token_expires_at, token_note ja esimerkkikutsut. Tunnuskenttä ja muut verkon tarvitsemat asiat eroavat:
Miksi hakea somen token jokaisessa työssä sen tallentamisen sijaan?
Koska osa uusiutuu päivän sisällä, ja credentials-kutsu vastaa aina tokenilla, joka on voimassa juuri sillä hetkellä. YouTuben Google-token kestää tunnin ja TikTokin päivän, ja easyCoexistence uusii molemmat ennen kuin ne umpeutuvat. Instagramin token kestää 60 päivää ja uusitaan hyvissä ajoin ennen sitä, jolloin syntyy uusi token. Facebook-sivun token ei vanhene, kun sivu pysyy yhdistettynä. Yksi pyyntö jokaisen työn alussa estää koodiasi kutsumasta verkkoa tokenilla, joka on umpeutunut.
Pitäisikö WhatsApp-numeron token tallentaa?
Kyllä. Se on Metan Embedded Signupista saatu yritystoken, jonka Meta rajaa juuri siihen perehdytettyyn asiakkaaseen. Ohjeet pyytävät tallentamaan sen omalle puolellesi, koska hallintapaneeli ei näytä sitä. Lue se uudelleen jokaisen connection.connected-tapahtuman jälkeen, sillä uudelleenyhdistäminen voi antaa uuden tokenin. Keskeytetyn tai poistetun numeron tokenia ei enää palauteta, ja asiakastoken, jonka Meta lakkaa hyväksymästä siitä huolimatta, että numero vastaa, poistetaan käytöstä, jolloin token_ready muuttuu arvoon false.
Mitä token_ready ja token_missing tarkoittavat?
token_ready on tosi, kun asiakastoken on tallessa ja yhteys on aktiivinen. Numerolla se voi olla epätosi heti yhdistämisen jälkeen, koska Meta joskus päättää Embedded Signupin ilman asiakkaan tokenin myöntämistä. Hostattu sivu pyytää silloin asiakasta suorittamaan yhdistämisen vielä kerran, ja tapahtumapäätepisteesi saa connection.token_missing-tapahtuman. Jos asiakas ohittaa tämän, numero vastaanottaa viestejä, koska sen tunnukset ovat voimassa, mutta ei voi lähettää. Uusi yhdistämisistunto kyseiselle asiakkaalle myöntää tokenin, eikä koskaan korvaa jo toimivaa tokenia. Somekanavilla ei ole token_missingiä: kirjautuminen tuottaa aina asiakkaan oman tokenin, joten token_ready seuraa tilaa.
Mitä tapahtuu, kun yhteydellä ei ole tokenia annettavana?
Vastaus on 200, jonka credentials-kentässä access_token on null ja mukana ohje siitä, mitä tehdä, eikä virhettä. Se koskee numeroa, jolla token_ready on false, keskeytettyä tai poistettua numeroa sekä kanavaa, jonka status ei ole connected. Tällöin ohje pyytää uutta yhdistämisistuntoa. 404 not_found tarkoittaa, että tunnus ei kuulu tilillesi, ja 502 credentials_unavailable tarkoittaa, että tuoretta somen tokenia ei voitu hakea tällä hetkellä. Yritä uudelleen ja tarkista kanavan tila, jos virhe toistuu.
Yleiset virheet
- YouTube- tai TikTok-tokenin tallentaminen konfiguraatiotiedostoon. Ne vanhenevat tunnin tai päivän sisällä, joten kutsu credentials-päätepistettä jokaisen työn alussa ja jätä uusiminen easyCoexistencelle.
- Viestien lähettäminen numerosta, jonka token_ready on false. Asiakkaan tokenia ei ole, jolla Metaa voisi kutsua; avaa uusi yhdistämisistunto kyseiselle asiakkaalle, joka myöntää sellaisen.
- TikTokin kutsuminen Authorization-otsakkeella. Sen Business API ottaa tokenin Access-Token-otsakkeessa, ja jokaisessa pyynnössä on tilin business_id.
- LinkedInin kutsuminen pelkällä bearer-tokenilla. LinkedIn vaatii myös otsakkeet LinkedIn-Version ja X-Restli-Protocol-Version, jotka on lueteltu required_headers-kentässä, ja URN:t poluissa URL-koodattuina.
easyCoexistence yhdistää asiakkaidesi WhatsApp-numerot sekä heidän Instagram-, Facebook-, TikTok-, YouTube- ja LinkedIn-tilinsä ja lisää kanavia. Taustajärjestelmällesi se luovuttaa jokaisen yhteyden tunnistetiedot pyynnöstä, uusii somen tokenit ja valvoo jokaista yhteyttä 24/7. US$ 9 – US$ 0.75 yhteydeltä kuukaudessa, hinta laskee yhteyksiä lisättäessä, ensimmäiset 3 päivää ilmaiseksi.
Usein kysytyt kysymykset
Onko WhatsApp-token asiakkaan oma?
Kyllä. Se on yritystoken, jonka Meta myöntää asiakkaan yhdistäessä Embedded Signupin kautta, ja se on rajattu juuri siihen asiakkaaseen. easyCoexistencen järjestelmätokenia ei koskaan paljasteta, ja kutsu palauttaa tokenin vain, kun token_ready on tosi.
Kuinka pitkään somen access-tokenit ovat voimassa?
YouTuben tunnin, TikTokin päivän ja Instagramin enintään 60 päivää, kun taas Facebook-sivun token ei vanhene. easyCoexistence uusii ne, jotka vaihtuvat, joten jokainen credentials-kutsu palauttaa tokenin, joka toimii juuri nyt.
Tarvitsenko oman kehittäjäsovelluksen jokaiseen verkkoon?
Et. Asiakkaat kirjautuvat easyCoexistencen omalla sovelluksella Metaan, TikTokiin, Googleen ja LinkedIniin, ja credentials-kutsu antaa taustajärjestelmällesi tokenin, jolla kutsut kyseisen verkon API:a suoraan.
Voiko avustaja, kuten Claude tai ChatGPT, lukea samat tunnistetiedot?
Kyllä. Kun se on kirjautunut tiliisi MCP-palvelimen kautta, se voi kutsua get_api_credentials-funktiota numerolle ja get_social_credentials-funktiota sometilille, ja se palauttaa samat tiedot kuin Partner API.
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