# SMS-kanava (Twilio)

URL: https://aihio.ai/docs/chatbot/sms-kanava
Kuvaus: Yhdistä oma Twilio-tilisi ja anna tekoälyagentin vastata SMS-viesteihin. Asiakas tuo numerot ja maksaa Twiliolle suoraan.

Aihio tukee oman Twilio-tilin käyttöä: yhdistät oman Twilio-tilisi, jolloin tekoälyagentti vastaa saapuviin SMS-viesteihin samasta numerosta josta asiakkaasi sen lähetti. Numerot pysyvät sinun omistuksessasi ja Twilion käyttömaksut menevät suoraan Twilio-tilillesi — Aihio ei välitä laskutusta.

## Edellytykset

- **Twilio-tili.** Kokeilutili riittää testaukseen, mutta tuotantokäytössä tarvitset aktiivisen tilin (ks. Twilion 10DLC-vaatimukset Yhdysvaltoihin lähetettäville viesteille).
- **SMS-kykyinen numero** Twilio-tililläsi. Numero voi olla suomalainen, eurooppalainen tai mikä tahansa Twilion tukema numero — Aihio ei rajoita maakohtaisesti.
- **Aihio-tilaus**, jossa on integraatiot käytössä (Starter-tasolta ylöspäin).

## Yhteyden luonti

1. **Hae Twilio-tunnukset**

   Kirjaudu [Twilio Consoleen](https://console.twilio.com). Etusivulla näet **Account SID** -arvon ja **Auth Token** -arvon (paina "View" nähdäksesi tokenin). Kopioi molemmat talteen.

   Account SID alkaa aina merkeillä `AC` ja on 34 merkkiä pitkä. Auth Token on 32 merkkiä.
2. **Avaa SMS-asetukset Aihiossa**

   Aihion ohjauspaneelissa: **Chatbotit → valitse chatbot → Integraatiot → Kanavat → SMS (Twilio)**.
3. **Syötä tunnukset ja numero**

   Liitä Account SID, Auth Token ja Twilio-numerosi E.164-muodossa (esim. `+358401234567`). Anna halutessasi vapaamuotoinen nimi numerolle (esim. "Tuotteen tuki").

   Aihio tarkistaa heti, että tunnukset toimivat ja että numero todella kuuluu samalle Twilio-tilille. Yleisimmät virhetilanteet:
   - **"Twilio hylkäsi tunnukset"** — tarkista että kopioit Auth Tokenin kokonaan.
   - **"Antamasi numero ei kuulu samalle Twilio-tilille"** — varmista että olet valinnut oikean Twilio-tilin ja että numero on E.164-muodossa.
   - **"Twilion palveluun ei juuri nyt saatu yhteyttä"** — Twilion API hetkellisesti pois käytöstä, yritä uudelleen muutaman minuutin kuluttua.
4. **Aseta webhook-osoite Twilio Consoleen**

   Yhteyden luonnin jälkeen Aihio näyttää **webhook-osoitteen** muodossa `https://app.aihio.ai/api/webhooks/twilio/sms`. Kopioi se.

   Twilio Consolessa: **Phone Numbers → Manage → Active numbers → valitse numero → Messaging Configuration**.
   - Kohtaan **"A message comes in"** liitä Aihion webhook-osoite ja valitse menetelmäksi `HTTP POST`.
   - Tallenna asetukset.
5. **Lähetä testiviesti**

   Lähetä omasta puhelimestasi SMS Twilio-numeroosi. Muutaman sekunnin sisällä saat takaisin tekoälyagentin vastauksen, ja keskustelu ilmestyy Aihion saapuneet-kansioon SMS-kanavamerkillä merkittynä.

   Jos vastausta ei tule, tarkista:
   - Sentry-virheloki (`channels/sms` -tagi)
   - Aihion saapuneet-kansiosta keskustelu — jos näet bottivastauksen mutta toimitusta ei merkitty onnistuneeksi, klikkaa keskustelua nähdäksesi virhesyyn.

## Miten se toimii

1. Asiakkaasi lähettää SMS:n Twilio-numerolle.
2. Twilio lähettää webhook-pyynnön Aihion palvelimelle (allekirjoitettu Twilion Auth Tokenilla — Aihio verifioi jokaisen pyynnön).
3. Aihion tekoälyagentti generoi vastauksen samalla logiikalla kuin verkkosivun chat-widgetillä — samat tietopohjat, sama system prompt.
4. Aihio lähettää vastauksen takaisin Twilion REST-rajapinnan kautta omasta Twilio-tilistäsi asiakkaasi puhelimeen.
5. Keskustelu tallentuu Aihion saapuneet-kansioon, jossa voit lukea sen ja tarvittaessa eskaloida ihmisagentille.

Vastausviesti voi olla enintään 1 600 merkkiä — Twilio jakaa pidemmät viestit automaattisesti useaan SMS-segmenttiin. Käyttömaksu lasketaan Twilio-tilisi laskulla per segmentti.

## Mitä Aihio EI tee

- **Ei välitä Twilion käyttömaksuja.** Twilio veloittaa sinulta suoraan SMS:t (Suomeen tyypillisesti noin 0,05 € / segmentti vuonna 2026). Aihion palvelumaksut eivät kasva SMS-volyymin myötä.
- **Ei tue MMS-viestejä** tällä hetkellä. Saapuvien viestien liitteet (kuvat) sivuutetaan; vain tekstisisältö viedään tekoälyagentille.
- **Ei rekisteröi 10DLC-brandeja puolestasi.** Yhdysvaltoihin lähetettävät viestit edellyttävät Twilion 10DLC-rekisteröintiä — hoida se Twilion oman prosessin kautta ennen tuotantokäyttöä.

## Irrotus

Aihion ohjauspaneelissa: **Integraatiot → Kanavat → SMS (Twilio) → Irrota Twilio**. Tallennetut tunnukset poistetaan välittömästi. Muista lisäksi poistaa webhook-osoite Twilio Consolesta, jotta Twilio ei yritä uudelleen lähettää viestejä Aihion palvelimelle.

## Tietosuoja

Twilio toimii alikäsittelijänä **vain** kun olet aktivoinut SMS-kanavan. Asiakas (sinä) on Twilion suora rekisterinpitäjä — Aihio toimii teknisenä välittäjänä. Yksityiskohdat löytyvät [tietojenkäsittelysopimuksesta](/data-processing-agreement) (kohta 6 — Alikäsittelijät) ja [tietosuojakäytännöstä](/privacy-policy).

Tunnukset (Account SID + Auth Token) tallennetaan Aihion tietokantaan AES-256-GCM-salattuina. Salaus-avain pidetään ympäristömuuttujassa, ei tietokannassa.