# Yhdistä agentti muihin palveluihin

URL: https://aihio.ai/ohjekeskus/tekoalyagentti/integraatiot\
Kuvaus: Valitse tiedon suuntaan sopiva rajapinta, määritä Zapier ja varmista yhteys oikealla testillä.

Yhteyden valinta alkaa siitä, mistä tieto tulee ja mitä sen jälkeen pitää tapahtua. Agentin keskustelunaikainen toiminto, ulkoisen palvelun agentille lähettämä viesti ja Aihion lähettämä tapahtuma ovat eri tehtäviä.

## Valitse tiedon suunta

| Tehtävä                                                       | Valitse                                                        | Ohje                                                              |
| ------------------------------------------------------------- | -------------------------------------------------------------- | ----------------------------------------------------------------- |
| Agentti hakee tai päivittää tietoa keskustelun aikana.        | HTTPS-toiminto omalle rajapinnalle.                            | [Mukautetut HTTP-toiminnot](/ohjekeskus/tekoalyagentti/toiminnot) |
| Oma sovellus lähettää viestin agentille ja käyttää vastausta. | Aihion viestirajapinta ja palvelimella säilytettävä API-avain. | [Viestirajapinta](/ohjekeskus/tekoalyagentti/viestirajapinta)     |
| Zap lähettää aiemman vaiheen tekstin agentille.               | Ohjattu Zapier-määritys.                                       | Seuraa alla olevia vaiheita.                                      |
| Oma vastaanotin käsittelee Aihion tapahtuman.                 | Allekirjoitettu webhook.                                       | [Webhookit](/ohjekeskus/tekoalyagentti/webhookit)                 |
| Keskusteluikkuna lisätään WordPress-sivulle.                  | Julkaisu ja asennusohje.                                       | [WordPress-asennus](/ohjekeskus/tekoalyagentti/wordpress-lisaosa) |

Avaa agentin **Integraatiot** ja tarkista työtilan käytettävissä olevat yhteydet. Luettelossa näkyvä määritystila kertoo Aihion puolella tallennetusta asetuksesta. Se ei yksin todista ulkoisen palvelun toimivan. Tulossa-ominaisuutta ei voi ottaa käyttöön valmiina yhteytenä.

## Määritä Zapier

Tarvitset agentin ja rajapintakäytön sallivan Aihio-tilauksen, työtilan tarvittavat käyttöoikeudet sekä Webhooks by Zapier -toiminnon mahdollistavan Zapier-tilauksen. Aihion määritys käyttää tätä toimintoa; kyseessä ei ole Zapierin sovellushakemistosta asennettava Aihio-sovellus.

1. **Luo yhteyden avain**

   Valitse **Integraatiot → Zapier → Määritä Zapier** ja **Luo API-avain ja
   jatka**. Jos avain on jo luotu, jatka olemassa olevalla avaimella.
2. **Tallenna avain turvallisesti**

   Uusi API-avain näkyy vain kerran. Kopioi se Zapierin määritykseen tai
   organisaatiosi turvalliseen salasananhallintaan. Älä lisää sitä verkkosivun
   selainkoodiin, kuvakaappaukseen tai tukipyyntöön.
3. **Määritä Zapin toimintovaihe**

   Lisää Zapierissa **Webhooks by Zapier**, tapahtuma **POST** ja tietomuoto
   **JSON**. Kopioi Aihion näyttämä osoite URL-kenttään. Lisää Data-osioon
   näkymän `chatbot_id` sekä `message`, jonka arvoksi valitset aiemman
   Zap-vaiheen viestin. Lisää Headers-osioon `x-api-key` ja tallentamasi avain.
4. **Testaa ennen julkaisua**

   Suorita toiminnon testi Zapierissa. Tarkista agentin palauttama vastaus ja
   kenttien arvot. Julkaise Zap vasta onnistuneen testin jälkeen ja varmista
   myös todellisen tapahtuman kulku. Testiviesti käyttää agentin rajapintaa ja
   voi kuluttaa viestikrediittejä.

> **Huomaa — API-avain luotu ei tarkoita Zap julkaistu:**
>
> Aihio ei voi varmistaa Zapin testausta tai julkaisua. Varmista ne Zapierissa.
> Työtilan Zapier-avain ja yleisen API-kortin tila ovat erillisiä; Zapierin
> määritys ei todista yleisen API-yhteyden käyttöönottoa.

## Jos yhteys ei toimi

| Havainto                               | Seuraava tarkistus                                                                                                                         |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| Avain ei ole enää näkyvissä.           | Käytä Zapieriin tallennettua avainta. Jos sitä ei ole tallessa, katkaise yhteys ja luo uusi; päivitä kaikki samaa avainta käyttävät Zapit. |
| Rajapinta hylkää pyynnön.              | Tarkista osoite, `x-api-key`, oikea agentti ja työtilan rajapintaoikeus. Älä kopioi avainta virheraporttiin.                               |
| Testi toimii mutta tapahtuma ei saavu. | Tarkista Zapin julkaisu, laukaiseva tapahtuma ja Zapierin ajohistoria.                                                                     |
| Pyyntö toistuu.                        | Selvitä uudelleenyritykset ja estä kirjoittavan vastaanottimen kaksoiskäsittely.                                                           |

**Katkaise yhteys** peruuttaa yhteyden API-avaimen. Keskeytä tarvittaessa myös Zapierin automaatio. Katkaisu ei peru ulkoisessa järjestelmässä jo tehtyjä muutoksia eikä poista siellä tallennettua tietoa.

## Toimintojen tilaustasot

Tarkista myös työtilassa näkyvä saatavuus ja mahdollinen lisäosa. Taulukko kertoo näiden toimintojen vähimmäistason; se ei ole työtilan käyttöraja tai kaikkien integraatioiden luettelo.

| Toiminto                | Vähimmäistaso |
| ----------------------- | ------------- |
| Edistyneet integraatiot | Pro           |
## Seuraavat vaiheet

- [Mukautetut HTTP-toiminnot](/ohjekeskus/tekoalyagentti/toiminnot) — Määrittele HTTPS-rajapintakutsu, jonka agentti täyttää ja palvelin suorittaa keskustelun aikana. Tunnukset säilytetään salattuina ja kutsut on suojattu.
- [Lähetä viesti API-rajapinnasta](/ohjekeskus/tekoalyagentti/viestirajapinta) — Kutsu tekoälyagenttia palvelimeltasi, jatka samaa keskustelua ja käsittele rajapinnan virhevastaukset.
- [Vastaanota tapahtumia webhookilla](/ohjekeskus/tekoalyagentti/webhookit) — Siirrä agentin tapahtumia omaan järjestelmääsi ja varmista saapuvien webhook-pyyntöjen aitous.