Tekstiviestit ja puhelut suoraan Make-skenaariosta
Make kutsuu volain REST API:a yleisen HTTP-moduulin kautta - skenaariosta lähetetään tekstiviesti, käynnistetään puhelu puheagentin kautta ja tulos palaa webhookina.
volain oman Make-yhteyden voi asentaa kutsulinkillä. Sillä voi lähettää tekstiviestejä, käynnistää puheluja ja ääniviestejä, lukea tietoja, kuten saldon, agentit ja numerot, sekä käynnistää skenaario automaattisesti tekstiviesti- ja puhelutapahtumista. Yhteys ei ole vielä Maken julkisessa sovellusluettelossa. Manuaalinen määritys HTTP- ja Webhooks-moduuleilla on alla vaihtoehtona.
1Valmistele avain connectioniksi
Moduulissa HTTP > Make a request lisätään otsake Authorization arvolla Bearer vk_SINUN_AVAIMESI (avain löytyy portaalista kohdasta tekoälyavustaja). Tallenna se uudelleen käytettäväksi yhteydeksi, jotta sitä ei tarvitse kirjoittaa uudelleen jokaiseen moduuliin erikseen.
2Lähetä tekstiviesti skenaariosta
Lisää moduuli HTTP > Make a request: metodi POST, osoite https://volai.cz/v1/messages, runko tyyppiä Raw (JSON) kentillä to ja body - arvot kannattaa mapata edellisen moduulin bundlesta (taulukon rivi, webhook) sen sijaan, että ne kirjoitettaisiin käsin. Ota käyttöön Parse response, jolloin vastauksen priceHal (hinta saldoyksikön sadasosina kaikista segmenteistä) ja segments jaetaan heti bundleen jatkomappausta varten - ilman sitä palaa vain raakateksti ja erillinen Parse JSON -moduuli on lisättävä. Diakriittisiä merkkejä sisältävä teksti vie useamman segmentin kuin pelkkä ASCII-viesti.
{
"to": "+420777123456",
"body": "Tilaus on valmis noudettavaksi."
}3Käynnistä puhelu puheagentin kautta
Lisää toinen moduuli HTTP > Make a request: POST https://volai.cz/v1/calls, runko Raw (JSON) kentillä to ja agentId olemassa olevalle puheagentille - agentilla on oltava oma numero liitettynä, muuten pyyntö päättyy virheeseen agent_no_number. Kenttää to ei yleensä kirjoiteta käsin vaan se mapataan edellisen moduulin bundlesta (esimerkiksi puhelinnumero Google Sheets -rivistä) - napsauta kenttää ja valitse muuttuja luettelosta. Myös tässä Parse response on kätevä: se jakaa käynnistetyn puhelun id:n suoraan bundleen, jolloin sen voi mapata eteenpäin ilman erillistä Parse JSON -moduulia. Moduuli vain käynnistää puhelun - varsinainen tulos (päättyi, ei vastattu, epäonnistui) selviää vasta seuraavan vaiheen webhookista.
{
"to": "+420777123456",
"agentId": "ag_kx91fa2b"
}4Ota tapahtumat vastaan Custom webhookilla
Lisää moduuli Webhooks > Custom webhook - Make luo URL-osoitteen ja kuittaa vastaanotetun pyynnön heti (mikä täyttää sivun /docs/webhooky vaatimuksen nopeasta vastauksesta 200). Tallenna sama osoite kutsulla PUT /v1/webhook yhdessä niiden tapahtumien luettelon kanssa, jotka sinua kiinnostavat. Huomaa: tyhjä events-kenttä ei tarkoita ei yhtään tapahtumaa vaan ehdottomasti kaikki - luettele ne siksi aina erikseen. Vastaus palauttaa myös secret-arvon - tallenna se heti, GET /v1/webhook ei palauta sitä enää.
curl -X PUT https://volai.cz/v1/webhook \
-H "Authorization: Bearer vk_SINUN_AVAIMESI" \
-H "Content-Type: application/json" \
-d '{"url": "https://hook.eu2.make.com/xxxxxxxx", "events": ["call.completed", "message.sent"]}'5Haaroita skenaario tapahtumatyypin mukaan
Webhookin rungon kenttä event (call.completed, call.failed, call.no_answer, call.missed, message.sent, message.received) erotellaan moduulilla Router tai haaran reunaan asetetulla suodattimella. Allekirjoituksen Volai-Signature tarkistus (HMAC-SHA256 arvosta {t}.{rawBody} omalla secret-arvolla) täydennetään sivun /docs/webhooky tarkan kaavan mukaan - arkaluonteisessa skenaariossa (maksut, kirjanpito) sitä ei saa jättää pois.
Mitä sillä voi tehdä
Iterator lähettää tekstiviestin koko yhteystietolistalle
Moduuli Iterator jakaa yhteystietolistan (esimerkiksi Google Sheetsistä tai JSON-kentästä) yksittäisiksi tietueiksi, ja HTTP-moduuli kutsuu sitten POST /v1/messages jokaiselle erikseen - tyypillisesti massalähetys tai muistutus koko asiakasryhmälle kerralla.
Yhteyden suodatin ratkaisee, kenelle soitetaan
Make voi asettaa ehdon suoraan moduulien väliseen yhteyteen - suodatin päästää eteenpäin vain ehdon täyttävät rivit (esimerkiksi aika on huomenna eikä asiakas ole vielä vahvistanut), ja vasta ne käynnistävät HTTP-moduulin kutsun POST /v1/calls.
Error handler siepkaa epäonnistuneen puhelun
HTTP-moduuliin, joka kutsuu osoitetta /v1/calls, lisätään error handler -reitti direktiivillä Ignore - yksittäisen puhelun epäonnistuminen (esimerkiksi virheellinen numero) kirjataan silloin taulukkoon tai lähetetään Slackiin käsin tarkistettavaksi, eikä koko skenaario kaadu.
Usein kysyttyä
- Onko volailla oma sovellus Make-marketplacessa?
- volain Make-yhteyden voi asentaa kutsulinkillä. Se tukee tekstiviestejä, puheluja, ääniviestejä, lukutoimintoja ja automaattisia käynnistimiä tekstiviesti- ja puhelutapahtumille. Yhteys ei ole vielä Maken julkisessa sovellusluettelossa. Jos haluat määrittää yhteyden manuaalisesti, seuraa alla olevia HTTP- ja Webhooks-vaiheita.
- Montako operaatiota kahden HTTP-moduulin skenaario kuluttaa?
- Jokainen moduulin suoritus lasketaan yhdeksi operaatioksi - skenaario, joka kutsuu osoitteita
/v1/messagesja sen jälkeen/v1/calls, kuluttaa suuruusluokkaa kaksi tai kolme operaatiota ajoa kohden sen mukaan, kuinka monta moduulia niiden välissä on. Operaatioiden rajan määrää Make-paketti, ei volai. - Miten HTTP-moduuliin asetetaan error handler, jotta yksittäisen puhelun epäonnistuminen ei pysäytä koko skenaariota?
- Napsauta HTTP-moduulia hiiren kakkospainikkeella, lisää error handler ja valitse Ignore, jolloin skenaario jatkuu. Resume antaa korvaavan tulosteen, Break pysäyttää ajon.
- Miksi Custom webhook palauttaa heti `Accepted`, ennen kuin skenaario ehtii valmiiksi?
- Moduuli toimii näin: se kuittaa vastaanoton heti tilalla 200 ja skenaario ajetaan loppuun taustalla. Kutsujan (esimerkiksi volain) tarvitsee saada 200 vain muutamassa sekunnissa.
- Miksi HTTP-moduuli jatkaa heti kutsun POST /v1/calls jälkeen, vaikka puhelu ei ole päättynyt?
POST /v1/callsvain käynnistää puhelun ja palauttaa heti senid:n. Tulos tulee myöhemmin webhookillacall.completed,call.failed,call.no_answertaicall.missed.