Näin rakennat tekoälyagenttituotteen asiakkaidesi WhatsAppiin, Instagramiin ja TikTokiin
Tekoälyagenttituote asiakkaiden kanavilla nojaa kolmeen osaan: hostattuun yhdistämislinkkiin jokaisen asiakkaan WhatsApp-numeroa tai sosiaalisen median tiliä varten, webhookeihin, jotka tuovat heidän viestinsä ja kommenttinsa taustajärjestelmääsi, jossa oma mallisi kirjoittaa vastaukset, jotka lähetetään kunkin verkon virallisen API:n kautta asiakkaan tokenilla, sekä tilatapahtumiin yhteyksille, jotka katkeavat. Agentti noudattaa kunkin verkon sääntöjä, kuten WhatsAppin 24 tunnin ikkunaa.
easyCoexistence antaa tuotteesi tekoälyagenteille äänen asiakkaidesi WhatsApp-numeroilla sekä heidän Instagram-, Facebook-, TikTok-, YouTube- ja LinkedIn-tileillään, ja uusia kanavia on tulossa.
WhatsAppin asiakaspalveluikkuna alkaa käyttäjän viestistä tai puhelusta; jokainen uusi viesti nollaa sen.
Mitä WhatsApp-yritys voi lähettää, kun asiakaspalveluikkuna sulkeutuu: ennalta hyväksytyt viestipohjat.
Metan ehdot kieltävät AI-palveluntarjoajia käyttämästä WhatsAppia tekoälyn tarjoamiseen ensisijaisena, ei satunnaisena toiminnallisuutena.
Instagram-tilin yksittäisen yksityisen vastauksen ikkuna kommenttiin, laskettuna kommentin tekemisestä.
WhatsApp Business -sovelluksen ja Cloud API:n kanssa käytetyn numeron kiinteä läpäisykyky.
Mitä tekoälyagenttituote tarvitsee kunkin asiakkaan kanavalta?
Neljä asiaa: tapa, jolla asiakas yhdistää kanavan, viestien pääsy taustajärjestelmääsi, token vastaamista varten sekä tieto siitä, milloin yhteys lakkaa toimimasta. Partner API kattaa jokaisen niistä, kun taas malli, kehotteet ja keskustelulogiikka pysyvät sinun. easyCoexistence yhdistää tilin, pitää käyttöoikeuden uusittuna ja valvoo sitä, ja vastauksesi lähtevät taustajärjestelmästäsi suoraan verkon API:n kautta.
Miten jokainen asiakas yhdistää kanavansa?
Taustajärjestelmäsi luo yhdistämisistunnon kutsulla POST /connect-sessions, jossa nimetään kanava, redirect_url ja asiakkaasi external_ref. Numeron kohdalla mukana ovat myös sen webhook_url ja webhook_verify_token. Asiakas avaa hostatun linkin, kirjautuu sisään Metalla, TikTokilla, Googlella tai LinkedInillä ja palaa sovellukseesi arvolla connection_id tai channel_id. Hän ei tarvitse easyCoexistence-tiliä, sähköpostia eikä korttia, ja jokainen avaimellasi tehty yhteys kuuluu sinun tilillesi.
Miten viestit ja kommentit päätyvät mallillesi?
Webhookien kautta niillä verkoilla, jotka niitä lähettävät. Meta toimittaa numeron viestit suoraan sen webhook_url-osoitteeseen, ja yrityksen henkilökunnan WhatsApp Business -sovelluksesta lähettämät viestit saapuvat sinne smb_message_echoes-tapahtumina. Instagramin ja Facebookin kommentit, maininnat ja yksityisviestit sekä TikTokin kommentit välitetään kunkin kanavan kohdeosoitteeseen, allekirjoitettuna sen salaisuudella. YouTube ja LinkedIn eivät lähetä kommenttitapahtumia, joten agentti lukee uudet kommentit niiden rajapintojen kautta aikataulun mukaan. Vastaa jokaiseen toimitukseen heti koodilla 2xx ja anna taustaprosessin kutsua mallia.
Miten agentti vastaa?
Verkon oman API:n kautta, taustajärjestelmäsi hakemilla tunnuksilla. WhatsApp-vastaus on POST-pyyntö numeron send_endpoint-osoitteeseen asiakkaan tokenilla; Instagramin tai Facebookin yksityisviesti menee tilin messages-päätepisteeseen; TikTok-vastaus lähetetään kommentin alle polkuun business/comment/reply/create/. Alla oleva luonnos vastaa WhatsApp-viesteihin: se tarkistaa salaisuuden URL-polusta, asettaa jonoon jokaisen saapuvan viestin ja vastaa sillä, mitä malli palauttaa.
import hmac, os, queue, threading
import requests
from flask import Flask, abort, request
EC = "https://easycoexistence.com/api/v1"
KEY = {"Authorization": f"Bearer {os.environ['EC_API_KEY']}"} # ec_live_...
PATH_SECRET = os.environ["WA_PATH_SECRET"] # the random part of each webhook_url
CONNECTIONS: dict[str, str] = {} # phone_number_id -> connection id, from your database
jobs: queue.Queue = queue.Queue()
app = Flask(__name__)
@app.route("/wa/<secret>", methods=["GET", "POST"])
def whatsapp(secret: str):
if not hmac.compare_digest(secret, PATH_SECRET):
abort(404)
if request.method == "GET": # Meta's handshake when the destination is set
if request.args.get("hub.verify_token") != os.environ["WA_VERIFY_TOKEN"]:
abort(403)
return request.args.get("hub.challenge", "")
for entry in request.get_json().get("entry", []):
for change in entry.get("changes", []):
if change.get("field") == "messages": # echoes and history are context, not prompts
value = change["value"]
for msg in value.get("messages", []):
jobs.put((value["metadata"]["phone_number_id"], msg))
return "", 200 # answer at once; dedupe on msg["id"], since Meta can deliver twice
def worker() -> None:
while True:
phone_number_id, msg = jobs.get()
conn = requests.get(f"{EC}/connections/{CONNECTIONS[phone_number_id]}",
headers=KEY, params={"credentials": 1}).json()
creds = conn["credentials"]
if not creds["access_token"]: # token_ready is false: a new connect session issues one
continue
reply = my_model(conn["external_ref"], msg) # your model, your prompt, your memory
requests.post(creds["send_endpoint"], # a reply to a fresh message is inside the 24 hours
headers={"Authorization": f"Bearer {creds['access_token']}"},
json={"messaging_product": "whatsapp", "to": msg["from"],
"type": "text", "text": {"body": reply}})
threading.Thread(target=worker, daemon=True).start()MCP-palvelin vai Partner API: kumpaa agentti käyttää?
Partner API, kun agentti on sinun tuotteesi ja asiakkaasi tuovat kanavat: taustajärjestelmäsi pitää avainta, vastaanottaa tapahtumat ja ajaa mitä tahansa valitsemaasi mallia. MCP-palvelin osoitteessa https://easycoexistence.com/api/mcp sopii avustajalle, kuten Claudelle tai ChatGPT:lle, joka toimii omalla easyCoexistence-tililläsi työkalujen kautta, joita se kutsuu pyynnöstä OAuth-kirjautumisen jälkeen. Avaimellasi yhdistetyt numerot ja kanavat ovat myös tällä tilillä, joten MCP-istunto voi käyttää niitä tiimisi omaan työhön.
| Partner API | MCP server | |
|---|---|---|
| Built for | Your product, serving your customers | An assistant working on your own account |
| Signs in with | An ec_live_ key, one per account | OAuth, from Claude, ChatGPT or another client |
| Incoming messages | Webhooks to your backend | Read when the assistant calls a tool |
| The model | Any model you run | The assistant's own |
| Replies | Your code calls each network's API | Tools such as send_message and reply_to_comment |
Miten toimistot ajavat agentteja monelle asiakkaalle?
Yhdellä tilillä, ja jokainen asiakas on merkitty. Välitä asiakkaan tunniste external_ref-kentässä jokaisessa yhdistämisistunnossa, näytä toimistosi nimi hostatulla sivulla partner_name-kentän kautta ja listaa yhden asiakkaan yhteydet kutsuilla GET /connections?external_ref= ja GET /channels?external_ref=. Jokainen yhteys laskutetaan toimistolle US$ 9–US$ 0,75 yhteydeltä kuukaudessa, ja hinta laskee yhteyksien lisääntyessä, kun taas Meta laskuttaa WhatsApp-keskusteluveloitukset asiakkaan omalle WhatsApp Business -tilille. Coexistence-tilassa asiakkaan henkilökunta vastaa edelleen WhatsApp Business -sovelluksessa agentin rinnalla.
Mitä sääntöjä agentin on noudatettava?
Verkkojen omia, ja koodisi tulisi tarkistaa ne ennen kuin mallin vastaus lähtee. Alustat noudattavat niitä asiakkaidensa puolesta, sillä Metan valvonta kohdistuu asiakkaan tiliin:
- WhatsApp: vapaamuotoiset viestit vain 24 tunnin sisällä asiakkaan viimeisimmästä viestistä; sen jälkeen hyväksytty viestipohja, lähetettynä API:n kautta, sillä WhatsApp Business -sovellus ei voi lähettää viestipohjia Coexistence-tilassa.
- WhatsApp: Metan ehdot kieltävät tekoälyn tarjoamisen ensisijaisena toiminnallisuutena, minkä Partner API -viite ilmaisee niin, ettei yleiskäyttöisiä tekoälyboteja sallita, ja sallivat hienosäädön vain WhatsApp-dataan yrityksen omaan yksinomaiseen käyttöön.
- Instagram ja Facebook: yksityisviestit 24 tunnin sisällä henkilön viimeisimmästä viestistä, ja yksi yksityinen vastaus kommenttiin 7 päivän sisällä sen tekemisestä.
- TikTok: vastaukset kommentteihin ovat julkisia, koska TikTok-yhteydellä ei ole yksityisviestejä.
- Volyymi: 20 viestiä sekunnissa Coexistence-numeroa kohden, ja markkinointiviestipohjat vaativat maksutavan asiakkaan WhatsApp Business -tilillä.
Miten agentti tietää, että kanava on lakannut toimimasta?
Tilatapahtumista. connection.disconnected tai channel.disconnected tarkoittaa, että vastaukset epäonnistuvat, kunnes asiakas yhdistää uudelleen. Keskeytä silloin kyseisen asiakkaan agentti, kerro asiakkaalle ja lähetä uusi yhdistämislinkki. connection.token_missing tarkoittaa, että numero voi vastaanottaa mutta ei vielä lähettää. Kun connection.connected tai channel.connected saapuu uudelleen, hae uudet tunnukset ja jatka. Jokainen tapahtuma on allekirjoitettu X-EC-Signature-otsikolla ja sitä yritetään uudelleen noin 33 tunnin ajan.
Yleiset virheet
- Annat mallin vastata yli 24 tunnin ikäiseen WhatsApp-viestiin vapaamuotoisesti. Ikkuna on sulkeutunut, joten tarkista asiakkaan viimeisin saapuva aika ja vaihda hyväksyttyyn viestipohjaan.
- Jaetun mallin kouluttaminen asiakkaiden WhatsApp-keskusteluilla. Metan ehdot sallivat hienosäädön WhatsApp Business Platform -dataan vain yrityksen yksinomaiseen käyttöön, ei koskaan muiden mallien parantamiseen.
- smb_message_echoes-tapahtumien käsittely asiakkaan viesteinä. Ne ovat yrityksen henkilökunnan sovelluksesta lähettämiä viestejä, joten anna ne mallille kontekstina, älä viesteinä, joihin vastataan.
- Tilin omiin vastauksiin vastaaminen. Instagram-yksityisviestit, jotka tili lähettää, palaavat kaikuina ja TikTok-vastaukset kommenttitapahtumina, joten ohita kaikki, minkä tili itse kirjoitti, tai agentti vastaa itselleen.
Saat hostatut yhdistämislinkit, tuoreet tunnukset, webhookit ja allekirjoitetut tilatapahtumat kunkin verkon virallisen API:n kautta, ja jokaista yhteyttä valvotaan ympäri vuorokauden. US$ 9–US$ 0,75 yhteydeltä kuukaudessa, ja hinta laskee yhteyksien lisääntyessä, ensimmäiset 3 päivää ilmaiseksi.
Usein kysytyt kysymykset
Voinko käyttää omaa tekoälymalliani?
Kyllä. Taustajärjestelmäsi vastaanottaa viestit, kutsuu valitsemaasi mallia ja vastaa verkon API:n kautta asiakkaan tokenilla. WhatsApp-numeron viestit kulkevat Metalta suoraan webhookiisi, eivät koskaan easyCoexistencen kautta.
Mitä Metan tekoälykäytäntö tarkoittaa WhatsApp-agentille?
Metan ehdot kieltävät tekoälypalveluntarjoajia käyttämästä WhatsApp Business Platformia tekoälyteknologian tarjoamiseen ensisijaisena, ei satunnaisena tai sivullisena toiminnallisuutena, sellaisena kuin Meta sen määrittää. Noudata sitä asiakkaidesi puolesta, samoin 24 tunnin ikkunaa ja hyväksyttyjä viestipohjia.
Voiko agentti lähettää yksityisviestejä TikTokissa, YouTubessa tai LinkedInissä?
Ei. Näillä verkoilla agentti toimii kommenteissa: TikTok-vastaukset ovat julkisia, ja YouTuben ja LinkedInin kommentteja luetaan ja niihin vastataan niiden rajapintojen kautta.
Mitä easyCoexistence maksaa tekoälyagenttituotteelle?
Yhteydeltä, samalla hinnalla jokaisessa verkossa: US$ 9–US$ 0,75 yhteydeltä kuukaudessa, ja hinta laskee yhteyksien lisääntyessä. Ensimmäiset 3 päivää ilmaiseksi. Meta laskuttaa WhatsApp-keskusteluveloitukset kunkin asiakkaan omalle WhatsApp Business -tilille.
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