SMS-kanava (Twilio)

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. 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 (kohta 6 — Alikäsittelijät) ja tietosuojakäytännöstä.

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