
# SMS-viestintä

Lähetä ja vastaanota tekstiviestejä (SMS) alustan kautta ja vastaanota saapuvia multimediaviestejä (MMS). SMS-palvelun tarjoaa Twilio, johtava puhelinpalveluntarjoaja, joka takaa luotettavan kattavuuden ja puhelinnumeroiden saatavuuden maailmanlaajuisesti.


---

## Yleiskatsaus

Sovelluksen SMS-viestintä mahdollistaa seuraavat toiminnot:

- Lähetä ja vastaanota tekstiviestejä yhteyshenkilöiden kanssa
- Vastaanota multimediaviestejä (kuvia, videoita, asiakirjoja) MMS-viesteinä
- Automatisoi vastaukset tekoälyagentilla
- Suorita tekstiviestipohjaisia lähetyksiä, mukaan lukien massalähetykset
- Huolehdi eri maiden säädösten noudattamisesta

---

## Miten SMS toimii

**Tekstiviestien käyttö edellyttää oman Twilio-tilin yhdistämistä.** Tekstiviestien käyttö on useimmissa maissa tiukasti säänneltyä – esimerkiksi **A2P 10DLC** Yhdysvalloissa (rekisteröintijärjestelmä, jota operaattorit käyttävät varmistaakseen yrityksen aitouden, jotta viestejä ei estetä roskapostina), brändirekisteröinti Australiassa, lähettäjätunnuksen hyväksyntä Euroopassa jne. – ja vaatimustenmukaisuus on ilmoitettava viestin lähettäjän omissa nimissä. Tästä syystä alusta ei tarjoa hallinnoituja tekstiviestinumeroita – tuot oman Twilio-tilisi, maksat Twiliolle suoraan numeroista ja viestikohtaisista maksuista, ja alusta hoitaa reitityksen, tekoälyn ja keskustelukerroksen niiden päällä.

Mitä saat, kun yhteys on muodostettu:

- **Maailmanlaajuinen kattavuus** kaikissa Twilion tukemissa maissa
- **Numerotyypit**, mukaan lukien paikalliset, mobiili- ja maksuttomat numerot
- **Saapuvien MMS-viestien tuki** – yhteyshenkilön lähettämä media tallennetaan keskusteluun (lähtevien MMS-viestien lähettämistä ei tueta; lähtevät tekstiviestit ovat vain tekstiä)
- **Ei alustan veloittamia tekstiviestien toimitusmaksuja** – maksat vain Twilion suorat viestikohtaiset operaattorimaksut. Jos tekoälyagentti luo vastauksen, kyseinen tekoälyvastaus kuluttaa tekoälypisteitä samalla tavalla kuin muissakin kanavissa.

> **WhatsApp Business API on erilainen.** WhatsApp Business API -numeroita voidaan käyttää alustan hallinnoimassa Twiliossa tai omassa Twiliossasi. Jos olet yhdistänyt oman Anthropic-avaimesi (BYOK), hallinnoidun Twilion WhatsApp-viestit maksavat 0,05 krediittiä kappaleelta, sekä saapuvat että lähtevät. Kaikilla muilla tileillä nämä toimituskulut sisältyvät jo tekoälykrediittien hintaan, joten erillistä viestikohtaista maksua ei ole. Katso [WhatsApp Business](whatsapp-business.md) kyseistä polkua varten.

> **Älä sekoita tätä Twilio-tili-korttiin.** Kanavat-sivulla on myös erillinen **Twilio-tili**-kortti, joka sijaitsee alempana listassa kuin **SMS Twilion kautta**. Se vaihtaa alustan kautta ostetut **WhatsApp**-numerosi omaan Twilio-tiliisi, eikä se liity tämän sivun tekstiviestiyhteyteen – sen vaihtaminen ei vaikuta tekstiviestinumeroosi. Katso kyseisen kortin täydellinen läpikäynti kohdasta [SMS-palveluntarjoaja](../settings/sms-provider.md).


> **Ei Twiliota? Käytä omaa Android-puhelintasi (Beta).** Pienen volyymin keskusteluviestinnässä voit ohittaa Twilion kokonaan ja lähettää tekstiviestejä oman Android-puhelimesi ja operaattoriliittymäsi kautta. Katso [Android-puhelin tekstiviestiyhdyskäytävänä](android-sms-gateway.md). Tämä sopii parhaiten kahdenkeskisiin vastauksiin ja tekoälykeskusteluihin – massatekstiviestien lähetykset vaativat edelleen Twilion.

---

## Twilio-tilin yhdistäminen

1. Napsauta vasemmassa sivupalkissa alareunan lähellä olevaa **Asetukset**-kohtaa.
2. Napsauta Asetukset-valikon vasemmassa reunassa kohdan **Kanavat** alta **Kanavat**.
3. Etsi **SMS Twilion kautta** -kortti ja napsauta **Yhdistä**. (Kanavat-sivulla tämä kortti sijaitsee alempana listassa, Telegramin, LINEn ja muiden kanavakorttien alapuolella.)


Yhdistäminen tapahtuu yhdellä lomakkeella, ei monivaiheisella ohjatulla toiminnolla:

1. **Account SID** — kopioi se Twilio-konsolistasi kohdasta **Account**.
2. **Auth Token** — kopioi se samasta paikasta kohdasta **Account → API credentials**. Se validoidaan Twiliota vasten, eikä sitä näytetä sinulle sen jälkeen.
3. **Phone number** — Twilio-tilisi tekstiviestikykyinen numero kansainvälisessä muodossa (esim. `+14155552671`).
4. Napsauta **Connect Twilio**. Sovellus validoi tunnistetiedot ja määrittää saapuvan verkkokoukun (webhook) Twilio-numeroosi automaattisesti – erillistä verkkokoukun määritystä tai testiviestivaihetta ei tarvita.


Kun yhteys on muodostettu, kortissa näkyy numerosi ja peitetty Account SID sekä **Edit**- ja **Disconnect**-toiminnot. Heti yhdistämisen (tai muokkaamisen) jälkeen sovelluksen määrittämä verkkokoukun URL-osoite näytetään kerran viitteeksi – sitä ei tallenneta, joten jos haluat nähdä sen uudelleen, napsauta **Edit** ja syötä samat tunnistetiedot uudelleen.

Mistä löydät Account SID- ja Auth Token -tiedot: kirjaudu sisään osoitteessa [console.twilio.com](https://console.twilio.com). Molemmat löytyvät pääkojelautasi **Account Info** -paneelista. Voit ostaa ja hallinnoida tekstiviestinumeroita suoraan Twilio-konsolissa – alustalla ei ole omaa käyttöliittymää tekstiviestinumeroiden ostamiseen.

> **Voit yhdistää yhden Twilio-numeron kerrallaan.** Jos haluat käyttää toista numeroa, napsauta yhdistetyn kortin **Edit**-painiketta ja syötä uudet tunnistetiedot – vanha numero katkaistaan ja uusi määritetään.

### SMS-viestien päivittäminen tai yhteyden katkaiseminen

Jos haluat vaihtaa tekstiviestinumeroasi tai Twilio-tunnistetietojasi, avaa **SMS via Twilio** Kanavat-sivulla, napsauta **Edit** ja syötä kaikki kolme kenttää uudelleen (Account SID, Auth Token ja puhelinnumero – lomake vaatii aina kaikki kolme, koska todennustunnistetta ei koskaan lähetetä takaisin selaimeen esitäyttöä varten). Jos haluat lopettaa tekstiviestien käytön, napsauta **Disconnect**; tämä tyhjentää saapuvan verkkokoukun Twilio-numerostasi ja poistaa yhteyden. Olemassa olevia keskusteluja ei poisteta.

---

## SMS-viestien lähettäminen ja vastaanottaminen

### Viestien vastaanottaminen

Kun numerosi on aktiivinen, saapuvat SMS-viestit ohjataan automaattisesti alustalle:

1. Yhteyshenkilö lähettää tekstiviestin puhelinnumeroosi.
2. Viesti näkyy **Chatit**-näkymässä reaaliajassa.
3. Uusi yhteyshenkilö luodaan automaattisesti, jos kyseessä on ensimmäinen viesti kyseiseltä lähettäjältä.
4. Jos tekoälyagentti käsittelee kyseistä keskustelua, se vastaa automaattisesti.

### Viestien lähettäminen

- **Manuaalinen vastaus:** Avaa keskustelu Chatit-osiossa ja kirjoita vastauksesi.
- **Lähetykset:** Määritä joukkotekstiviestien lähetys tavoittaaksesi yhteystiedot laajasti — tekstiviesti on täysin tuettu lähtevä kanava, aivan kuten WhatsApp. Katso [Lähetykset](../broadcasts/broadcasts.md).
- **AI-agentti:** Määritä agentti vastaamaan saapuviin viesteihin automaattisesti.
- **Ajastetut viestit:** Ajasta viestit lähetettäväksi tiettynä ajankohtana.

### MMS (Multimediaviestit)

SMS-numerot tukevat **saapuvia** MMS-viestejä, joten kun yhteyshenkilö lähettää sinulle mediatiedostoja, ne tallennetaan keskusteluun:

- Kuvat (JPEG, PNG, GIF)
- Videot (MP4)
- Äänitiedostot
- Asiakirjat (PDF)

Medialiitteet tallennetaan automaattisesti ja ne ovat käytettävissä keskustelunäkymässä. Lähtevien MMS-viestien **lähettämistä** alustalta ei tällä hetkellä tueta – lähtevät tekstiviestit ovat vain tekstiä.

::: note
**Huomautus:** Saapuvien MMS-viestien saatavuus vaihtelee maittain ja palveluntarjoittain. MMS-viestejä tuetaan laajasti Yhdysvalloissa ja Kanadassa, mutta tuki voi olla rajoitetumpaa muualla.
:::


---

## Click-to-Text (SMS) -linkin lisääminen verkkosivustollesi

WhatsAppin kaltaista kelluvaa SMS-widgetiä ei ole, mutta voit silti lisätä verkkosivustollesi (tai sähköpostiin, QR-koodiin jne.) painikkeen tai linkin, joka avaa vierailijan viestisovelluksen valmiiksi syötetyllä numerollasi. Tämä käyttää tavallista `sms:`-linkkiä.

Muoto on:

```
sms:+NUMBER
```

Käytä numeroasi kansainvälisessä muodossa, mukaan lukien plusmerkki. Esimerkiksi:

```
sms:+15551234567
```

### Lisääminen painikkeeseen

Linkitä mikä tahansa painike tai teksti kyseiseen osoitteeseen:

```html
<a href="sms:+15551234567">Text us</a>
```

Verkkosivuston rakennustyökalussa (Wix, Squarespace, WordPress, Webflow jne.) lisää painike tavalliseen tapaan ja liitä `sms:+15551234567` sen "linkki"- tai "URL"-kenttään.

### Viestin esitäyttö

Voit esitäyttää viestin, jonka vierailija lähettää. iPhone ja Android odottavat tätä hieman eri tavoin, joten käytä tätä yhdistettyä muotoa molempien kattamiseksi:

```
sms:+15551234567?&body=Hi!%20I%20have%20a%20question
```

Viestin välilyönnit on kirjoitettava muodossa `%20`.

> **Hyvä tietää.**
> - Klikattavat tekstiviestilinkit toimivat vain laitteessa, jossa on tekstiviestisovellus – ne toimivat puhelimissa, mutta pöytätietokoneella linkin klikkaaminen ei yleensä tee mitään.
> - Nämä linkit avaavat vierailijan **oman** tekstiviestisovelluksen; ensimmäinen viesti tulee vierailijan puhelinnumerosta, ei sinun. Keskustelu näkyy sen jälkeen Chateissa kuten mikä tahansa muu saapuva tekstiviesti, kun he painavat lähetä-painiketta.
> - Vältä `sms:`-linkin lisäämistä **lähettämääsi tekstiviestiin** – useimmat puhelimet eivät tee siitä klikattavaa. Ne toimivat parhaiten verkkosivuilla, sähköposteissa ja QR-koodeissa.

---

## Äänipuhelut SMS-numeroosi

Yhdistettyyn Twilio SMS-numeroosi tulevat äänipuhelut käsitellään kokonaan omalla Twilio-tililläsi – alusta ei asenna vastaajatervehdystä, tallennusta tai transkriptiota numeroihin, jotka tuot mukanasi. Jos haluat vastaajan SMS-numeroosi, määritä se Twilio-konsolissasi.

::: note
**Huomautus:** Alustan automaattinen vastaaja koskee vain WhatsAppia varten alustan kautta ostettuja numeroita, ei Twilio-numeroita, jotka yhdistät tekstiviestejä varten.
:::


---

## Säädöstenmukaisuus

Tekstiviestisääntely hoidetaan suoraan Twilion kanssa omalla tililläsi. Alusta ei tee vaatimustenmukaisuusilmoituksia puolestasi tekstiviestien osalta — niiden on oltava yrityksesi nimissä. Yleisiä vaatimuksia:

- **A2P 10DLC** (Yhdysvallat) — rekisteröi brändisi ja kampanjasi The Campaign Registryyn Twilion kautta ennen kuin lähetät viestejä yhdysvaltalaisiin numeroihin.
- **Maksuttomien numeroiden vahvistus** (Yhdysvallat ja Kanada) — vaaditaan maksuttomien numeroiden tekstiviestien lähettämiseen.
- **Lähettäjätunnuksen rekisteröinti** (suuri osa Eurooppaa, Lähi-itää ja Aasian ja Tyynenmeren aluetta) — Twilio hoitaa lähetysprosessin.
- **Henkilöllisyystodistukset** (säännellyt maat, kuten Saksa, Ranska, Intia jne.) — ladataan Twilio-konsoliin numeroa ostettaessa.

Jos tilisi vaatii virallisen sääntelypaketin (yhdysvaltalainen maksuton numero, brittiläinen matkapuhelinnumero tai vastaava), **Regulatory compliance** -kortti Channels-sivulla käynnistää ja seuraa kyseistä lähetystä Twilion kautta.

Katso [Twilion sääntelyohjeet](https://www.twilio.com/docs/messaging/compliance) nähdäksesi täydellisen maakohtaisen erittelyn.

### Viestinnän vaatimustenmukaisuuden parhaat käytännöt

- **Hanki suostumus** ennen tekstiviestien lähettämistä yhteystiedoille. Tämä on lakisääteinen vaatimus useimmilla lainkäyttöalueilla (TCPA Yhdysvalloissa, GDPR Euroopassa jne.).
- **Sisällytä ohjeet tilauksen peruuttamiseen** lähetysviesteissä (esim. "Vastaa STOP peruuttaaksesi tilauksen").
- **Kunnioita peruutuspyyntöjä** välittömästi.
- **Tunnistaudu** viesteissä – vastaanottajien tulee tietää, kuka heihin ottaa yhteyttä.
- **Noudata paikallisia säädöksiä** niiden maiden osalta, joissa yhteystietosi sijaitsevat.

---

## Vianmääritys

### Viestit eivät mene perille

- Varmista, että vastaanottajan puhelinnumero on oikeassa kansainvälisessä muodossa (esim. +1234567890).
- Tarkista, että Twilio-tililläsi on positiivinen saldo ja että yhdistetyt tunnistetiedot ovat yhä voimassa.
- Varmista, ettei numeroa ole poistettu käytöstä tai vapautettu Twilio-konsolissasi.
- Tarkista viestin tila keskustelunäkymästä virhetietojen varalta – Twilio-virhekoodit näkyvät suoraan, ja jokainen niistä on selitetty [virhelokissa](../settings/error-log.md#sms-twilio).
- Jotkin maat estävät ulkomaisista numeroista tulevat viestit – osta kyseiseen maahan paikallinen Twilio-numero.

### Numero ei lähetä tai vastaanota viestejä

- Varmista, että numero on aktiivinen Twilio-konsolissasi.
- Varmista, että **Channels**-sivulle yhdistetyt Twilio-tunnistetiedot vastaavat edelleen tiliä, joka omistaa numeron.
- Säännellyissä maissa varmista, että A2P 10DLC, lähettäjätunnus tai muut Twilion vaatimustenmukaisuusvaiheet on suoritettu.

### MMS-viestit eivät toimi

- Vahvista, että MMS-viestit ovat tuettuja vastaanottajan maassa.
- Tarkista, että tiedostokoko on rajojen sisällä (yleensä 5 Mt MMS-viesteille).
- Varmista, että tiedostomuoto on tuettu (JPEG, PNG, GIF, MP4, PDF).

### Saapuvia viestejä ei tule

- Lähetä testitekstiviesti puhelinnumeroosi henkilökohtaisesta puhelimestasi.
- Tarkista, että numero näkyy yhdistettynä Channels-sivulla.
- Jos ongelma jatkuu, kokeile yhdistää numero uudelleen SMS via Twilio -kortin kautta – alusta suorittaa teknisen määrityksen automaattisesti uudelleen.

---

## Parhaat käytännöt

- **Käytä paikallisia numeroita** niiden maiden osalta, joissa yhteystietosi sijaitsevat. Paikallisista numeroista lähetetyillä viesteillä on korkeampi luottamus ja toimitusaste.
- **Pidä viestit ytimekkäinä.** Tekstiviestin pituus on rajoitettu 160 merkkiin per segmentti. Pidemmät viestit jaetaan useisiin segmentteihin, mikä lisää kustannuksia.
- **Älä luota emojeihin tai erikoismerkkeihin.** Jotta jokainen tekstiviesti pysyisi yhtenä (halvempana) segmenttinä, alusta puhdistaa lähtevän tekstin automaattisesti tavallista tekstiviestikoodausta varten: emojit poistetaan, ja kaarevat lainausmerkit, ajatusviivat, ellipsit ja vastaavat merkit muutetaan vastaaviksi perusmerkeiksi. Tavallisen tekstiviestijoukon ulkopuoliset merkit poistetaan, joten ne eivät näy tekstiviestissä.
- **Ajoita viestisi sopivasti.** Vältä viestien lähettämistä virka-ajan ulkopuolella vastaanottajan aikavyöhykkeellä.
- **Seuraa toimitusasteita.** Jos huomaat huonoa toimitusta tietyillä alueilla, harkitse paikallisen numeron hankkimista kyseiseen maahan luottamuksen ja toimitettavuuden parantamiseksi.
- **Määritä tekoälyagentti** vastaamaan saapuviin viesteihin nopeasti, erityisesti virka-ajan ulkopuolella.
