Kirjaudu sisäänAloita ilmainen kokeilu
Meta Tech Provider

WhatsApp API tekoälyagenteille: virallinen pääsy minuuteissa, ilman Tech Provider -asemaa

Tekoälyagentti saa virallisen WhatsApp-käyttöoikeuden Metan Cloud API:n kautta. Numero, joka pysyy WhatsApp Business -sovelluksessa, liittyy siihen Tech Providerin tai Solution Partnerin kautta. Voit itse tulla sellaiseksi, ja se vaatii yritysvahvistuksen, App Review -videot ja Embedded Signup -toteutuksen. Voit myös yhdistää numeron palveluntarjoajan kautta, joka on jo sellainen: numero liittyy minuuteissa ja agentti saa MCP-työkalut tai API-tunnukset.

easyCoexistence on riippumaton Meta Tech Provider: se yhdistää WhatsApp Business -numeron Cloud API:hin Coexistencen kautta minuuteissa, joten agentti saa virallisen pääsyn ja yritys säilyttää sovelluksen.

Tech Provider

Metan vaatimus sille, joka ottaa käyttöön numeron, joka pysyy WhatsApp Business -sovelluksessa: Tech Provider- tai Solution Partner -asema.

2 videos

App Review pyytää yhden videon viestistä, joka lähetetään sovelluksestasi, ja yhden videon, jossa sovelluksesi luo viestipohjan.

Advanced access

Mitä App Review myöntää oikeuksille whatsapp_business_messaging ja whatsapp_business_management, jotka molemmat vaaditaan Tech Provider -asemaan.

October 15, 2026

Kun Meta poisti käytöstä Embedded Signup v2:n ja v3:n ja kehotti integraatiot siirtymään v4:ään.

20 msg/s

Numeron kiinteä läpäisykyky, kun sitä käytetään sekä WhatsApp Business -sovelluksessa että Cloud API:ssa.

1 hour

Kuinka kauan hostattu yhdistämislinkki pysyy voimassa, kun alusta ottaa asiakkaan numeron käyttöön Partner API:n kautta.

Mitä tekoälyagentti tarvitsee WhatsAppin virallista käyttöä varten?

Tarvitaan neljä asiaa Metan Cloud API:sta. Puhelinnumeron ID ja access token, jolla on whatsapp_business_messaging-oikeus, jotta agentti voi kutsua messages-endpointia. Webhook-endpoint, johon Meta toimittaa saapuvat viestit, ja lisäksi sovelluksen kanssa jaetulla numerolla smb_message_echoes niille vastauksille, jotka ihminen kirjoittaa puhelimella. Hyväksytyt viestipohjat, koska kirjoitettu viesti tavoittaa vain sen, joka on kirjoittanut viimeisen 24 tunnin aikana. Ja tapa huomata, milloin yhteys katkeaa, koska puhelimen sovellus toimii edelleen, vaikka API-puoli lakkaa toimimasta.

Ihmisten ensimmäisenä löytämä oikotie on WhatsApp Web -automaatio, joka kirjautuu sisään linkitettynä laitteena. Se rikkoo WhatsAppin käyttöehdot ja vaarantaa numeron, riippumatta siitä, mitä agentti sen päällä tekee.

Mitä Tech Provider -reitti sisältää?

Metan oma vaiheistus, tässä järjestyksessä. Jokainen vaihe on maksuton, eikä mitään voi ostaa nopeammin: tarkastukset etenevät Metan aikataulun mukaan, eikä Meta julkaise aikataulua, joten varaudu viikkoihin eikä päiviin ennen kuin ensimmäisen asiakkaan numero yhdistyy. Sen jälkeen taustajärjestelmän on pysyttävä käynnissä: tokenin vaihto jokaisen rekisteröitymisen jälkeen, webhook-vastaanotin, numerokohtainen reititys ja katkosten valvonta, kuten Metan 14 päivän käyttämättömyyssääntö.

1Business verificationName, address, phone, email and website checked by Meta
2Meta appThe WhatsApp use case and a connected business portfolio
3App ReviewTwo videos, then advanced access to both WhatsApp permissions
4Embedded SignupVersion 4 or later, with WhatsApp Business app onboarding
5Your backendToken exchange, webhooks, routing and monitoring

Mikä on lyhyempi reitti?

Yhdistä numero palveluntarjoajan kautta, joka on jo käynyt tämän prosessin läpi. easyCoexistencen kanssa yritys käyttää Metan Embedded Signupia ja skannaa koodin WhatsApp Business -sovelluksella. Se vie noin kaksi minuuttia, ja numero liittyy Cloud API:hin yrityksen omaan portfolioon, kun sovellus toimii edelleen. Agentti saa pääsyn siinä muodossa, jota se käyttää: MCP-työkalut assistentille, kuten ChatGPT, Claude, Claude Code tai Codex, tai numeron tunnukset ja webhookit koodille, jota ajat itse.

Connect through easyCoexistenceBecome a Tech Provider
Meta app and App ReviewNot needed: the number joins through oursYours to build and pass
Embedded SignupHosted, with the QR scan in the appYou integrate version 4 and host the flow
First number connectedMinutes after signing upAfter verification and review
Webhook trustA secret in your URL, or X-EC-Signature on forwarded messagesYour app secret signs Meta's deliveries
Disconnection alertsEvery number watched 24/7, 14-day rule includedMonitoring you build and run
Who owns the WhatsApp Business AccountThe business, in its own portfolioThe business

Miten agentti saa numeron tunnukset?

get_api_credentials-työkalun kautta tai numeron sivulta hallintapaneelista. Työkalu palauttaa Graph API:n perus-URL-osoitteen, WhatsApp Business Accountin ID:n, puhelinnumeron ID:n, lähetysendpointin ja, jos sellainen on, yrityksen oman access tokenin, rajattuna sen WhatsApp-resursseihin. Kun asiakastokenia ei ole myönnetty, token palautetaan null-arvona ja huomautuksena siitä, että numeron yhdistäminen uudelleen hallintapaneelista myöntää sellaisen, korvaamatta toimivaa tokenia. Sovelluksen salaisuutta ei tarvitse hakea, koska Meta allekirjoittaa webhookit easyCoexistencen sovellussalaisuudella, jota ei koskaan jaeta. Työkalu vaatii aktiivisen paketin, koska tokenilla voi lähettää viestejä.

Send a reply with the returned credentials
curl -X POST "$SEND_ENDPOINT" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "5511999998888",
    "type": "text",
    "text": { "body": "Your order #1042 is ready for pickup." }
  }'

Miten saapuvat viestit tavoittavat agentin?

Jokaisella numerolla on kaksi tilaa, joita vaihdetaan set_inbound_mode-työkalulla tai numeron sivulla. Suoraan omalle palvelimellesi: set_webhook_destination ohjaa Metan suoraan HTTPS-endpointiisi, jonka on vastattava Metan GET-kättelyyn, eikä easyCoexistence koskaan näe viestejä, joten automaatiot ovat pois päältä. Koska Meta allekirjoittaa nämä toimitukset easyCoexistencen sovellussalaisuudella, aseta URL-polkuun pitkä satunnainen salaisuus ja hylkää pyynnöt, joista sitä puuttuu.

Automaatiot päällä: Meta toimittaa viestit easyCoexistencelle, automaatiot voivat vastata, ja valinnainen Forward URL vastaanottaa Metan alkuperäisen payloadin kentässä ”value”, allekirjoitettuna X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 ”<t>.<body>”> -muodossa käyttäen kertaalleen näytettyä salaisuutta. Automaation vaihe ”Call my webhook” antaa viestin ja chatin 10 viimeisintä viestiä agentille, ja se lähettää vastauksen, kun vastauksesi on {"reply": "..."} 20 sekunnin sisällä.

Mitä rajoja agentin on noudatettava?

Metan rajoja, ja ne ovat samat minkä tahansa palveluntarjoajan kautta. Agentti, joka tuntee ne etukäteen, välttää virheet, jotka näyttävät bugeilta:

  • 20 viestiä sekunnissa numeroa kohden, Metan asettama raja numeroille, jotka on jaettu WhatsApp Business -sovelluksen kanssa.
  • Kirjoitetut viestit vain 24 tunnin sisällä asiakkaan viimeisimmästä viestistä; sen jälkeen hyväksytty viestipohja.
  • Viestipohjat lähtevät vain API:n kautta, koska sovellus ei voi lähettää niitä Coexistence-numerolla.
  • Ihmisen sovelluksessa kirjoittamat vastaukset saapuvat smb_message_echoes-tapahtumina; keskeytä agentti kyseisessä chatissa, muuten asiakas saa kaksi vastausta.
  • Ryhmäkeskustelut eivät synkronoidu API:hin, joten agentti toimii kahdenkeskisissä keskusteluissa.
  • Kontaktit ja enintään 6 kuukauden kahdenkeskiset chatit tuodaan kerran, vain jos suora webhook-kohde on tallennettu 24 tunnin sisällä yhdistämisestä; numero, jolla automaatiot ovat päällä, ei saa tuontia.
  • Ääni- ja videopuhelut toimivat yhä sovelluksessa, mutta Cloud API ei välitä puheluita Coexistence-numerolla, joten agentti toimii tekstillä.

Voiko alusta yhdistää omien asiakkaidensa numerot tällä tavalla?

Kyllä, Partner API:n kautta. Sitä kautta SaaS-yritys tai agentuuri ottaa asiakkaansa käyttöön ilman omaa Tech Provider -asemaa. Luo avain create_api_key-työkalulla (se alkaa ec_live_-etuliitteellä ja näytetään kerran), kutsu sitten POST /api/v1/connect-sessions omalta backendiltäsi tai create_connect_link assistentista, saadaksesi hostatun linkin, joka on voimassa 1 tunnin. Asiakas suorittaa Metan ponnahdusikkunan ja QR-skannauksen siellä ja palaa redirect_url-osoitteeseesi connection_id:n kanssa. GET /api/v1/connections/:id?credentials=1 palauttaa asiakkaan oman tokenin, ja tilatapahtumat, kuten connection.disconnected, saapuvat X-EC-Signature-allekirjoitettuina. Jokainen numero laskutetaan tilillesi samoissa numerokohtaisissa portaissa.

Yleiset virheet

  • X-Hub-Signature-256-allekirjoituksen tarkistaminen suorassa kohteessa. Meta allekirjoittaa easyCoexistencen sovellussalaisuudella, jota ei koskaan jaeta, joten aidot toimitukset eivät läpäise tarkistusta. Luota URL:ssa olevaan pitkään satunnaiseen salaisuuteen tai käytä välitystä X-EC-Signature-allekirjoituksella.
  • Vastaanotto n8n:n WhatsApp Trigger -solmulla. Se odottaa omaa Meta-sovellustasi; käytä sen sijaan yleistä Webhook-solmua, jonka URL:ssa on salaisuus.
  • smb_message_echoes-tapahtumien huomiotta jättäminen. Agentti vastaa silloin henkilön jo puhelimella kirjoittaman vastauksen päälle, ja asiakas lukee kaksi vastausta.
  • Suoran webhook-kohteen tallentaminen päiviä yhdistämisen jälkeen tai numeron jättäminen automaatioille. Metan kertaluonteinen tuonti kontakteista ja enintään 6 kuukauden chateista vaatii suoran kohteen tallennettuna 24 tunnin sisällä yhdistämisestä.
Näin teet tämän EasyCoexistencen avulla

Agentti toimii yli 30 MCP-työkalun kautta tai kunkin numeron tunnusten ja webhookien kautta, ja jokaista numeroa valvotaan 24/7 hälytyksillä. US$ 9 numeroa kohden kuukaudessa, joka laskee US$ 0,75:een numeroiden määrän kasvaessa. Ensimmäiset 3 päivää ovat ilmaisia.

Usein kysytyt kysymykset

Tarvitsenko oman Meta-sovelluksen?

Ei. Numero otetaan käyttöön easyCoexistencen Meta-sovelluksella, ja se pysyy yrityksen omassa portfoliossa ja WhatsApp Business Accountissa. Koodisi lähettää yrityksen omalla tokenilla get_api_credentials-työkalusta, joten omaa sovellustasi ei tarvita, ellet myöhemmin rakenna sellaista.

Voivatko agentti ja tiimi käyttää numeroa samaan aikaan?

Kyllä. Meta peilaa viestit Cloud API:n ja WhatsApp Business -sovelluksen välillä, joten agentin lähettämä viesti näkyy puhelimen sovelluksen chat-ketjussa, ja tiimin sovelluksessa kirjoittama teksti tulee järjestelmääsi smb_message_echoes-tapahtumina.

Mitkä agenttikehykset toimivat sen kanssa?

Mikä tahansa asiakas, joka puhuu MCP:tä HTTP:n yli OAuthilla, kuten ChatGPT, Claude, Claude Code, Codex ja Cursor, sekä kaikki koodi, joka kutsuu Metan Graph API:a: Node.js, Python, n8n, LangChain, OpenAI Agents SDK tai Vercel AI SDK. Taustalla oleva API on Metan oma, joten agentin sisällä ei ole mitään omistuksellista.

Onko yleiskäyttöinen tekoälyassistentti sallittu WhatsAppissa?

Metan Business Solution Terms -ehtojen kohta 4.7 estää yleiskäyttöisten tekoälyassistenttien tarjoajia tarjoamasta niitä WhatsApp Business Platformilla, kun tekoäly on ensisijainen toiminto Metan määrittelemällä tavalla. Ehdot ovat voimassa 15. tammikuuta 2026 alkaen. Yritys, joka käyttää tekoälyä omiin asiakkaisiinsa tukeen, myyntiin tai varauksiin, ei ole kohteena, ja Euroopan unionin ja Brasilian sääntelyviranomaiset ovat velvoittaneet Metan keskeyttämään tai peruuttamaan säännön kilpailevien assistenttien osalta.

Lue lisää

Valmis aloittamaan?

Ota WhatsApp Coexistence käyttöön minuuteissa, ei kuukausissa. Sovellus toimii edelleen puhelimessa.

Aloita ilmainen kokeilu

Vahvistettu