# WhatsApp Business Tools MCP: Näin yhdistät WhatsApp Businessin tekoälyagenttiin
> Metan virallinen WhatsApp Businessin MCP-palvelin: mitä agentti voi tehdä, Claude Coden yhteyskomento, käyttöönotto Codexissa ja ChatGPT:ssä sekä beetaversion rajoitukset.
Source: https://ailoot.ai/blog/fi/whatsapp-business-mcp/
Canonical: https://ailoot.ai/blog/fi/whatsapp-business-mcp/
Language: fi
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-234
Revision: sha256-7baec25ae7aba0d3a465190fdf0cdf64fccba063c4a9f79bca2d69621ca9ba71
Meta julkaisi 15. syyskuuta 2026 virallisen WhatsApp Business Tools MCP -palvelimen. Se yhdistää tekoälyagentin—Claude Coden, Codexin, ChatGPT:n tai Cursorin—WhatsApp Business Platformiin. Sen sijaan, että siirtyisit Developer Consolen, Business Managerin ja API-dokumentaation välillä, kuvailet tehtävän agentille, ja se lisää numeron, luo viestimallin, määrittää webhookit ja lähettää testiviestin.
Palvelin on yhä betavaiheessa: käyttöoikeutta jaetaan asteittain, ja julkaisu on tarkoitettu kehitykseen ja testaukseen, ei laajamittaiseen tuotantoviestintään. Alla kuvataan neljän asiakkaan valmistelut ja yhteyden muodostamisen vaiheet. Komennot ja asetukset tarkistettiin Metan virallisesta dokumentaatiosta 18. syyskuuta 2026.
Tietoa Ailootin kanssa työskentelystä on [dokumentaatiossa](https://ailoot.ai/docs/).
## Mikä WhatsApp Business Tools MCP on?
Tärkeimmät kohdat
Tämä on Metan virallinen etäkäyttöinen MCP-palvelin, joka antaa tekoälyagentille työkaluja WhatsApp Business Platformin hallintaan: tileihin, puhelinnumeroihin, viestimalleihin, webhookeihin ja testiviesteihin. Käyttöoikeus perustuu OAuthiin: kirjaudut sisään Meta-tililläsi ja valitset yritykset, joiden kanssa annat palvelimen työskennellä.
MCP (Model Context Protocol) on avoin standardi ulkoisten järjestelmien yhdistämiseen tekoälyagentteihin. Lue siitä lisää artikkelista [MCP-palvelimet Claude Codeen: 7 valmista integraatiota](https://ailoot.ai/blog/fi/mcp-servers-claude-code/). Vahvistetut yhteydet asennuskomentoineen löytyvät MCP-luettelosta.
Ennen tätä julkaisua WhatsApp-integraation käyttöönotto eteni näin: avaa Developer Console, luo sovellus, yhdistä yritys, lisää puhelinnumero, vahvista se koodilla, luo token, määritä webhook, tarkista API-dokumentaatio—ja kirjoita vasta sitten ensimmäinen koodirivi.
Meta kuvaa palvelimen taustalla olevaa ajatusta näin (käännetty englannista):
Kuvailet, mitä tarvitset, ja agentti selvittää itse tarvittavat tilit, puhelinnumerot, mallit ja API-kutsut.
— Meta for Developers, https://developers.facebook.com/blog/post/2026/09/15/whatsapp-business-messaging-mcp-ai-agent/
Metalla on nyt kaksi MCP-palvelinta, ja ne on helppo sekoittaa keskenään. Meta Social Technologies MCP on yleiskäyttöinen kehittäjätyökalu dokumentaation hakuun, Graph API -päätepisteiden löytämiseen ja sovellusvirheiden selvittämiseen. WhatsApp Business Tools MCP on tarkoitettu WhatsApp-tilien, puhelinnumeroiden, mallien, webhookien ja testiviestien hallintaan. Ne täydentävät toisiaan, ja voit yhdistää molemmat tarvittaessa.
## Mitä agentti voi tehdä yhteyden muodostamisen jälkeen?
Tärkeimmät kohdat
Palvelin tukee neljää tehtäväryhmää. Puhelinnumeron käyttöönotto alusta asti: lisää numero, lähetä vahvistuskoodi, vahvista numero ja rekisteröi se. Viestimallit: luo ja muokkaa malli sekä tarkista sen hyväksyntätila. Webhookit: määritä callback-URL ja tilaa kenttiä. Edellytysten tarkistukset: agentti havaitsee, jos käyttöehtoja ei ole hyväksytty tai maksamista ei ole määritetty, ja antaa suoran linkin ongelman korjaamiseen.
Palvelimen työkalut on ryhmitelty `whatsapp_biz_`-etuliitteen alle. Virallisen dokumentaation mukaan:
- Yleiskatsaus: `whatsapp_biz_businesses`, `whatsapp_biz_accounts`, `whatsapp_biz_phone_numbers`—käytettävissäsi olevat yritykset, tilit ja puhelinnumerot.
- Puhelinnumeron käyttöönotto: `whatsapp_biz_add_phone_number`, `whatsapp_biz_send_verification_code`, `whatsapp_biz_verify_phone_number`, `whatsapp_biz_register_phone_number`.
- Mallit: `whatsapp_biz_list_templates`, `whatsapp_biz_get_template`, `whatsapp_biz_create_template`, `whatsapp_biz_update_template`, `whatsapp_biz_delete_template`.
- Viestit: `whatsapp_biz_send_message`—vapaamuotoinen teksti 24 tunnin keskusteluikkunan aikana tai hyväksytty malli sen ulkopuolella; agentti vahvistaa vastaanottajan kanssasi ennen lähettämistä.
- Webhookit: `whatsapp_biz_configure_webhooks`, `whatsapp_biz_subscribe_webhook`.
- Tilin käyttöönotto: `whatsapp_biz_configure_payments`, `whatsapp_biz_verify_business`, `whatsapp_biz_system_user_token`—linkki järjestelmäkäyttäjän tokenin luomiseen suoria Cloud API -kutsuja varten.
Kun asiakas lähettää yritykselle ensimmäisen viestin, avautuu asiakaspalveluikkuna: voit vastata vapaamuotoisella tekstillä 24 tunnin ajan. Jokainen uusi asiakasviesti pidentää ikkunaa. Kun se sulkeutuu, voit ottaa asiakkaaseen yhteyttä vain hyväksytyllä mallilla. Agentti tuntee tämän säännön ja ehdottaa mallin lähettämistä tavallisen tekstin sijaan, jos vastaanottaja on ikkunan ulkopuolella.
Palvelimessa on sisäänrakennetut käyttöoikeuksien hallintatoiminnot. Kirjaudut sisään Meta-tililläsi ja valitset tietyt yritykset; tokeneita ei lisätä keskusteluhistoriaan. Jokainen lukutoiminto suoritetaan sinun kontekstissasi, kutsut kirjataan ja muutoksia tekevät toiminnot edellyttävät todennettua käyttäjää; pelkkä palvelinsovelluksen avain ei riitä.
## Mitä kannattaa tarkistaa ennen yhdistämistä?
Tärkeimmät kohdat
Kolme edellytystä: MANAGE-rooli hallittavassa Meta-yrityksessä; järjestelmänvalvojan oikeudet sovellukseen, jossa WhatsApp-skenaario on käytössä; sekä WhatsApp Business Cloud API -ehtojen hyväksyminen. Jos jokin puuttuu, työkalu palauttaa virheen, joka selittää ongelman ja sisältää linkin sivulle, jolla voit korjata sen.
Palvelin toimii puolestasi ja käyttää vain omia resurssejasi, joten tarkista seuraavat asiat ennen ensimmäistä kutsua:
1. Sinulla on Meta-yritys, jossa olet järjestelmänvalvoja (MANAGE-rooli).
2. Sinulla on Meta-sovellus, jossa WhatsApp Business Messaging -skenaario on käytössä (tai WhatsApp-tuote vanhemmissa sovelluksissa), ja olet kyseisen sovelluksen järjestelmänvalvoja; yritystason käyttöoikeudet eivät yksin riitä.
3. Yritys on hyväksynyt WhatsApp Business Cloud API -ehdot—ilman tätä puhelinnumeroiden rekisteröinti ja viestien lähettäminen estetään.
Metan mukaan käyttöehtoihin, maksutapoihin ja yrityksen vahvistamiseen liittyviä ongelmia ilmenee usein ilman selkeää selitystä. Agentti tarkistaa ne etukäteen ja antaa suoran linkin, josta voit hyväksyä ehdot, määrittää maksutavan tai aloittaa yrityksen vahvistamisen.
## Miten yhdistät palvelimen Claude Codeen?
Tärkeimmät kohdat
Suorita komento `claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools`, kirjoita sitten istunnossa `/mcp`, valitse palvelin ja kirjaudu sisään Metan kautta. Kun käynnistät asiakkaan uudelleen, sinun on kirjauduttava uudelleen sisään.
Jos et ole vielä asentanut Claude Codea, aloita oppaasta [Claude Coden asentaminen viralliselta verkkosivustolta](https://ailoot.ai/blog/fi/install-claude-code/).
1. ### Lisää palvelin
Suorita päätteessä:
```bash
claude mcp add --transport http whatsapp_business_tools https://mcp.facebook.com/whatsapp_business_tools
```
Palvelin on etäpalvelin, joten sitä ei tarvitse asentaa paikallisesti.
2. ### Kirjaudu sisään Metan kautta
Kirjoita Claude Code -istunnossa `/mcp` ja valitse `whatsapp_business_tools`. Selainikkuna avautuu Meta-tilille kirjautumista varten. Jos selain ei avaudu, kopioi linkki asiakkaasta ja avaa se manuaalisesti.
3. ### Anna käyttöoikeudet
Valitse suostumusnäkymässä yritykset ja WhatsAppia käyttävät sovellukset, joihin annat käyttöoikeuden. Palvelin pyytää kolmea käyttöoikeutta: `business_management` (etsi yritykset, joissa olet järjestelmänvalvoja), `whatsapp_business_management` (tilit, puhelinnumerot, mallit, webhookit) ja `whatsapp_business_messaging` (lähetä viestejä numeroistasi).
4. ### Tarkista yhteys
Käynnistä Claude Code uudelleen, kirjaudu uudelleen sisään komennolla `/mcp` ja kysy agentilta, mitä työkaluja se näkee palvelimella `whatsapp_business_tools`. Tee sitten turvallinen lukutoiminto: ”Listaa yritykset, joita voin hallita”—agentti kutsuu työkalua `whatsapp_biz_businesses`. Jos työkaluja ei ole tai saat kirjautumisvirheen, tarkista palvelimen osoite ja kirjaudu uudelleen sisään.
OAuth-kirjautuminen on sidottu asiakkaan käynnistämiseen: Claude Coden uudelleenkäynnistyksen jälkeen sinun on kirjauduttava uudelleen sisään. Voit peruuttaa käyttöoikeuden milloin tahansa facebook.com-sivuston asetuksissa kohdassa ”Business Integrations”.
## Miten yhdistät Codexin, ChatGPT:n ja Claude Desktopin?
Tärkeimmät kohdat
Kaikki kolme käyttävät samaa palvelimen osoitetta ja OAuth-kirjautumista; asetuksissa on eroa vain sijainnissa. Codex App: Settings, MCP Servers, lisää Streamable HTTP -palvelin. ChatGPT: Settings, Plugins, lisää URL-osoitteen avulla. Claude Desktop: Settings, Connectors, mukautettu liitin.
**Codex App.** Avaa asetukset (rataskuvake vasemmassa alakulmassa), siirry kohtaan MCP Servers ja valitse Add servers. Valitse Streamable HTTP ja anna seuraavat tiedot:
- Nimi: `WhatsApp Business Tools`
- URL: `https://mcp.facebook.com/whatsapp_business_tools`
- Todennus: OAuth
Klikkaa Authenticate ja kirjaudu sisään selaimessa.
**ChatGPT.** Settings, Plugins, Browse plugins, oikean yläkulman ”+”-kuvake. Anna nimi, sama URL-osoite ja valitse todennustavaksi OAuth.
**Claude Desktop.** Settings, Connectors, Add custom connector. Nimi: `WhatsApp Business Tools`; URL: sama palvelimen osoite.
Kun olet lisännyt sen mihin tahansa asiakkaaseen, tee samat tarkistukset: käynnistä uudelleen, kirjaudu uudelleen sisään, katso työkaluluettelo ja lue yritysluettelo turvallisesti.
## Mitä ensimmäisessä istunnossa tapahtuu: yritysluettelosta testiviestiin?
Tärkeimmät kohdat
Toimintajärjestys on seuraava: listaa yritykset, valitse yksi, tarkastele sen tilejä ja puhelinnumeroita, lisää puhelinnumero, lähetä vahvistuskoodi tekstiviestillä tai puheluna, vahvista numero koodilla, rekisteröi se, luo malli, lähetä testiviesti ja määritä webhook. Annat tekstiviestikoodin itse agentille.
Tyypillinen ensimmäinen istunto yhdistetyllä palvelimella:
1. ”Listaa yritykset, joita hallinnoin”—agentti kutsuu työkalua `whatsapp_biz_businesses`, ja sinä valitset tarvitsemasi.
2. ”Näytä tämän yrityksen WhatsApp-tilit ja puhelinnumerot”—`whatsapp_biz_accounts` ja `whatsapp_biz_phone_numbers` sekä niiden tilat.
3. ”Lisää testipuhelinnumeroni tiliin”—`whatsapp_biz_add_phone_number`.
4. ”Lähetä vahvistuskoodi tekstiviestillä”—`whatsapp_biz_send_verification_code`. Koodi saapuu puhelimeesi.
5. ”Vahvista numero koodilla 123456”—`whatsapp_biz_verify_phone_number`, minkä jälkeen rekisteröi numero työkalulla `whatsapp_biz_register_phone_number`.
6. ”Luo `order_update`-malli vastaanottajien suosimalla kielellä tilausilmoituksia varten”—`whatsapp_biz_create_template`; agentti antaa linkin mallin hyväksyntätilaan.
7. ”Lähetä testiviesti numerooni”—`whatsapp_biz_send_message`; agentti vahvistaa vastaanottajan ennen lähettämistä.
8. ”Määritä webhook osoitteeseen [https://example.com/webhook](https://example.com/webhook)”—`whatsapp_biz_configure_webhooks` ja tilaa tapahtumat työkalulla `whatsapp_biz_subscribe_webhook`.
Tämän jälkeen asiakkaiden saapuvat viestit tulevat määritettyyn osoitteeseen—yleensä CRM-järjestelmä, asiakastukipalvelu tai botti hakee ne sieltä. Toteutat viestien käsittelyn kyseisessä osoitteessa erikseen; palvelin hoitaa vain määritykset.
## Mitä rajoituksia betaversiossa on?
Tärkeimmät kohdat
Palvelin on betavaiheessa: työkalujen valikoima voi muuttua, ja käyttöoikeutta jaetaan asteittain, ei kaikille kerralla. Julkaisu on tarkoitettu kehitykseen ja testaukseen; se ei sovellu laajamittaiseen tuotantoviestintään. Jokaisen työkalun käytössä on käyttäjäkohtainen pyyntöraja, ja asiakkaan uudelleenkäynnistyksen jälkeen sinun on kirjauduttava uudelleen sisään.
Palvelimessa on neljä rajoitusta, jotka kannattaa pitää mielessä.
**Betavaihe.** Metan mukaan käyttöliittymä ja työkalujen valikoima voivat muuttua, ja käyttöoikeutta jaetaan asteittain. Jos et vielä pysty yhdistämään palvelimeen, sitä ei ehkä ole vielä otettu käyttöön sinulle.
**Käyttötarkoitus.** Julkaisu on tarkoitettu kehitykseen ja testaukseen; sitä ei ole tarkoitettu massaviestien lähettämiseen tuotannossa. Tuotantoviestintään tarvitset täyden Cloud API -integraation—esimerkiksi järjestelmäkäyttäjän tokenin, jonka luomiseen linkin tarjoaa työkalu `whatsapp_biz_system_user_token`.
**Rajat.** Kunkin työkalun pyyntömäärää rajoitetaan käyttäjäkohtaisesti. Jos ylität rajan, työkalu palauttaa rajarajoituksesta kertovan virheen—odota ja yritä uudelleen.
**24 tunnin ikkunan sääntö.** Asiakkaan keskusteluikkunan ulkopuolella voit lähettää vain hyväksyttyjä malleja.
## Miksi tällä on merkitystä yritykselle?
Tärkeimmät kohdat
Nyt voit hoitaa WhatsApp-integraation alkuvaiheen käyttöönoton yhdessä keskustelussa agentin kanssa: se tuntee työvaiheet ja ymmärtää alustan virheilmoituksia. Tärkeimpiä käyttötapauksia ovat asiakastuki, tilaus- ja ajanvarausilmoitukset sekä mallien valmistelu.
Tyypillinen pienyrityksen tilanne: asiakkaat lähettävät viestejä WhatsAppissa, ja haluat vastata nopeasti sekä lähettää tilauksen tilaa koskevia ilmoituksia. Aiemmin käyttöönotto edellytti, että työskentelit itse useissa Metan hallintapaneeleissa tai palkkasit kehittäjän. Nyt voit hoitaa tämän osuuden keskustelemalla agentin kanssa. Saapuvien viestien käsittely omaan osoitteeseesi pitää silti toteuttaa erikseen—se on seuraava tehtävä webhookin määrittämisen jälkeen.
Palvelimesta on hyötyä myös silloin, kun integraatiosi on jo käytössä. Viestimalleja pitää päivittää säännöllisesti: esimerkiksi uuden kampanjan tai uuden ilmoitustekstin vuoksi. Palvelimen kautta agentti luo tai muokkaa mallin ja näyttää sen hyväksyntätilan lähettämättä sinua hallintapaneeliin.
Samankaltaista toimintatapaa—agentti yhdistyy ulkoiseen järjestelmään ja työskentelee sen kanssa kuvauksesi perusteella—havainnollistetaan dokumentaation avulla oppaassa Näin yhdistät NotebookLM:n Claude Codeen MCP:n kautta.
## Mitä seuraavaksi?
Tärkeimmät kohdat
Tarkista edellytykset, yhdistä palvelin yhdellä komennolla, kirjaudu sisään ja lue yritysluettelo turvallisesti. Lisää sitten testipuhelinnumero ja lähetä ensimmäinen viesti. Muista, että palvelin on betavaiheessa: valmistele täysi Cloud API -integraatio tuotantoviestintää varten.
Palvelimen julkistamisesta on kulunut kolme päivää. Voit aloittaa yhdellä komennolla, kirjautua sisään Metan kautta ja pyytää sitten agentilta listan yrityksistäsi. Seuraavaksi tarpeidesi mukaan: puhelinnumerot, mallit, webhookit ja testiviestit.
Muita tapoja yhdistää agentti ulkoisiin järjestelmiin esitellään kokoelmassa [MCP-palvelimet Claude Codeen](https://ailoot.ai/blog/fi/mcp-servers-claude-code/)—siinä on seitsemän muuta toimivaa integraatiota eri tehtäviin.
### Lähteet
- [Meta for Developers: WhatsApp Business Tools MCP:n julkistus (15.09.2026)](https://developers.facebook.com/blog/post/2026/09/15/whatsapp-business-messaging-mcp-ai-agent/)
- [Meta: WhatsApp Business Tools MCP:n dokumentaatio](https://developers.facebook.com/documentation/mcp/whatsapp-business-tools-mcp)
- [Meta: Kehittäjille tarkoitettujen MCP-palvelimien yleiskatsaus](https://developers.facebook.com/documentation/mcp)
- [WhatsApp Business Platform: Dokumentaatio](https://developers.facebook.com/documentation/business-messaging/whatsapp)
Tutustu [Ailootiin](https://ailoot.ai/).
## Kysymyksiä tästä oppaasta: WhatsApp Business Tools MCP: Näin yhdistät WhatsApp Businessin tekoälyagenttiin
### Mikä on turvallisin ensimmäinen yhteystarkistus?
Tarkista OAuth-kirjautumisen jälkeen työkalulista ja lue hallittavissasi olevat yritykset. Tämä tarkistaa pääsyn ennen puhelinnumeron lisäämistä, mallipohjien luomista, webhookien määritystä tai testiviestin lähettämistä.
### Rakentaako webhookin määrittäminen myös viestinkäsittelyn?
Ei. MCP-palvelin määrittää callback-osoitteen ja tilaukset, mutta sinun pitää rakentaa erikseen CRM, tukipalvelu tai botti, joka vastaanottaa ja käsittelee saapuvat viestit tässä osoitteessa.
## Ailoot · Yritys ja sen projektisalkku
Ailoot perustuu kertyneeseen toimintakokemukseen, laajaan asiakaskuntaan, vakaaseen palveluun ja jatkuvaan KPI-seurantaan.
Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa.
Ailoot hyödyntää tätä toimintakokemusta tarjotessaan API-yhteyden tekoälytoimintoihin asiakkaiden tuotteissa, agenteissa, sovelluksissa ja automaatioissa.