Liigu sisu juurde
Saage 50 kr
REST API

SMS-id ja kõned otse Make'i stsenaariumist

Make kutsub volai REST API-t üldise HTTP-mooduli kaudu - stsenaariumist saate saata SMS-i, käivitada hääleagendiga kõne ja saada tulemuse tagasi webhookina.

1Seadistage võti ühendusena

Moodulis HTTP > Make a request lisage päis Authorization väärtusega Bearer vk_TVUJ_KLIC (võtme leiate portaalist jaotisest AI assistent). Salvestage see korduvkasutatava ühendusena, et te ei peaks seda iga mooduli juures uuesti sisestama.

2Saatke stsenaariumist SMS

Lisage moodul HTTP > Make a request: meetod POST, URL https://volai.cz/v1/messages, keha tüüpi Raw (JSON) väljadega to ja body - väärtused võite vabalt kaardistada eelmise mooduli bundle'ist (tabeli rida, webhook) käsitsi sisestamise asemel. Lülitage sisse Parse response, et priceHal (hind heller-ühikutes kõigi segmentide eest) ja segments vastusest kohe bundle'isse jaotuksid ja neid saaks edasi kaardistada - ilma selleta saate ainult toortekstina ja peaksite lisama eraldi mooduli Parse JSON. Diakriitikuga tekstil tuleb segmente rohkem kui puhtalt ASCII-sõnumil.

json
{
  "to": "+420777123456",
  "body": "Tellimus on valmis."
}

3Käivitage kõne hääleagendi kaudu

Lisage teine moodul HTTP > Make a request: POST https://volai.cz/v1/calls, keha Raw (JSON) väljadega to ja olemasoleva hääleagendi agentId - agendil peab olema määratud oma number, muidu lõpeb päring veaga agent_no_number. Välja to ei kirjuta te tavaliselt käsitsi, vaid kaardistate selle eelmise mooduli bundle'ist (näiteks Google Sheetsi rea telefoninumbri) - klõpsake väljal ja valige menüüst muutuja. Ka siin tuleb kasuks Parse response: see jaotab käivitatud kõne id kohe bundle'isse, et seda saaks edasi kaardistada ilma eraldi Parse JSON mooduli. Moodul kõne ainult käivitab - tegeliku tulemuse (lõppes, ei vastatud, ebaõnnestus) saate teada alles järgmise sammu webhookist.

json
{
  "to": "+420777123456",
  "agentId": "ag_kx91fa2b"
}

4Võtke sündmused tagasi vastu Custom webhooki kaudu

Lisage moodul Webhooks > Custom webhook - Make genereerib teile URL-i ja kinnitab saabunud päringu kohe (see täidab kiire 200-vastuse tingimuse aadressilt /docs/webhooky). Salvestage sama aadress päringuga PUT /v1/webhook koos teid huvitavate sündmuste loendiga. Tähelepanu: tühi massiiv events ei tähenda ühtki sündmust, vaid absoluutselt kõiki - loetlege need alati. Vastus annab ka secret - salvestage see kohe, GET /v1/webhook seda enam ei tagasta.

bash
curl -X PUT https://volai.cz/v1/webhook \
  -H "Authorization: Bearer vk_TVUJ_KLIC" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://hook.eu2.make.com/xxxxxxxx", "events": ["call.completed", "message.sent"]}'

5Hargnege stsenaarium sündmuse tüübi järgi

Eristage webhooki kehas välja event väärtusi (call.completed, call.failed, call.no_answer, call.missed, message.sent, message.received) mooduliga Router või filtriga haru servas. Allkirja Volai-Signature kontroll (HMAC-SHA256 üle {t}.{rawBody} teie secret-iga) lisage täpse valemi järgi aadressilt /docs/webhooky - tundliku stsenaariumi puhul (maksed, raamatupidamiskanded) ärge seda vahele jätke.

Mida sellega teha saab

Iterator saadab SMS-id üle kontaktiloendi

Moodul Iterator jaotab kontaktide massiivi (näiteks Google Sheetsist või JSON-massiivist) üksikuteks kirjeteks ja HTTP-moodul kutsub siis iga kirje jaoks eraldi POST /v1/messages - tavaliselt massiteade või meeldetuletus kogu kliendirühmale korraga.

Filter ühenduses otsustab, kellele helistada

Make lubab tingimuse asetada otse mooduleid ühendavale joonele - filter laseb edasi ainult tingimusele vastavad read (näiteks tähtaeg on homme ja klient pole veel kinnitanud) ja alles need käivitavad HTTP-mooduli POST /v1/calls jaoks.

Error handler püüab ebaõnnestunud kõne kinni

Lisage /v1/calls kutsuvale HTTP-moodulile error handleri haru direktiiviga Ignore - ühe kõne ebaõnnestumise (näiteks vigane number) saate kirjutada tabelisse või saata käsitsi kontrollimiseks Slacki, ilma et kogu stsenaarium kukuks.

Korduma kippuvad küsimused

Kas volai jaoks on Make'i turuplatsil oma rakendus?
Veel mitte - piisab üldistest moodulitest HTTP ja Webhooks, mis on Make'is alati saadaval. Oma rakendus Make'is on Make Technology Partner Programi küsimus, millega me praegu ei tegele.
Mitu operatsiooni kulutab stsenaarium kahe HTTP-mooduliga?
Iga mooduli käivitus loetakse üheks operatsiooniks - stsenaarium, mis kutsub /v1/messages ja seejärel /v1/calls, kulutab ühe jooksu kohta suurusjärgus kaks kuni kolm operatsiooni, sõltuvalt sellest, mitu moodulit nende vahel on. Operatsioonide limiidi määrab teie Make'i pakett, mitte volai.
Kuidas seadistada HTTP-mooduli kohale error handler, et ühe kõne ebaõnnestumine kogu stsenaariumi ei peataks?
Klõpsake HTTP-moodulil paremklõpsuga ja lisage error handleri haru. Selle sees valige direktiiv Ignore - stsenaarium eirab viga ja jätkab, justkui poleks moodul mingit väljundit tagastanud. Kui järgmised moodulid vajavad puuduva väljundi asemel asendusväärtust, kasutage Resume koos oma varuväljundiga. Break-i võtke appi ainult siis, kui soovite jooksu kohe peatada ja seejärel käsitsi või automaatselt uuesti käivitada.
Miks Custom webhook tagastab `Accepted` kohe, enne kui stsenaarium lõpetab?
Nii Custom webhooki moodul vaikimisi töötab - kinnitab vastuvõtu staatusega 200 ja tekstiga Accepted kohe ning stsenaarium jookseb seejärel taustal lõpuni. Helistajale (näiteks volai'le) piisab, kui ta saab 200 mõne sekundi jooksul - see on täidetud.
Miks HTTP-moodul läheb pärast POST /v1/calls kohe edasi, kuigi kõne pole veel lõppenud?
POST /v1/calls kõne ainult käivitab ja tagastab selle id - sünkroonselt, hetkega. Kas kõne tõesti läbi läks, lõppes või ebaõnnestus, selgub alles hiljem webhooki call.completed / call.failed / call.no_answer / call.missed kaudu. Stsenaarium ei pea seetõttu midagi ootama ega pollima - piisab, kui sellele tulemusele ühendada ülalkirjeldatud Custom webhooki moodul.

Proovige kohe järele

Registreeruge ja esimesed 50 kr on meie kingitus.

Hankige 50 kr krediitiAvage dokumentatsioon