SMS un zvani tieši no Make scenārija
Make izsauc volai REST API ar vispārīgo HTTP moduli - no scenārija var sūtīt SMS, sākt zvanu ar balss aģentu, un rezultāts atgriežas kā webhook.
1Sagatavojiet atslēgu kā savienojumu
Modulī HTTP > Make a request pievienojiet galveni Authorization ar vērtību Bearer vk_TVUJ_KLIC (atslēgu atradīsiet portālā sadaļā AI asistents). Saglabājiet to kā atkārtoti izmantojamu savienojumu, lai nebūtu jāievada katrā modulī atsevišķi.
2Nosūtiet SMS no scenārija
Pievienojiet moduli HTTP > Make a request: metode POST, URL https://volai.cz/v1/messages, ķermenis Raw (JSON) ar laukiem to un body - vērtības ieteicams kartēt no iepriekšējā moduļa bundle (tabulas rinda, webhook), nevis rakstīt ar roku. Ieslēdziet Parse response, lai priceHal (cena simtdaļās, visiem segmentiem kopā) un segments no atbildes uzreiz nonāktu bundle tālākai kartēšanai - bez tā tiek iegūts tikai neapstrādāts teksts, un būtu jāpievieno atsevišķs Parse JSON modulis. Ja ziņā ir burti ar diakritiskajām zīmēm vai citi speciālie simboli, segmentu ir vairāk nekā tīri ASCII ziņā.
{
"to": "+420777123456",
"body": "Jusu pasutijums ir gatavs izsniegsanai."
}3Sāciet zvanu ar balss aģentu
Pievienojiet vēl vienu moduli HTTP > Make a request: POST https://volai.cz/v1/calls, ķermenis Raw (JSON) ar to un esoša balss aģenta agentId - aģentam jābūt piešķirtam numuram, citādi pieprasījums beidzas ar kļūdu agent_no_number. Lauku to parasti nerakstāt ar roku, bet kartējat no iepriekšējā moduļa bundle (piemēram, tālruņa numuru no Google Sheets rindas) - noklikšķiniet uz lauka un izvēlnē izvēlieties mainīgo. Arī šeit noder Parse response: tas uzsāktā zvana id izklāj bundle, un to var kartēt tālāk bez atsevišķa Parse JSON moduļa. Modulis zvanu tikai sāk - faktiskais rezultāts (pabeigts, neatbildēts, neizdevies) atnāk tikai ar webhook nākamajā solī.
{
"to": "+420777123456",
"agentId": "ag_kx91fa2b"
}4Saņemiet notikumus atpakaļ ar Custom webhook
Pievienojiet moduli Webhooks > Custom webhook - Make ģenerē URL un saņemto pieprasījumu apstiprina nekavējoties (tas izpilda ātrās 200 atbildes prasību no /docs/webhooky). To pašu adresi saglabājiet ar PUT /v1/webhook kopā ar sarakstu ar notikumiem, kas jūs interesē. Uzmanību: tukšs lauks events nenozīmē nevienu notikumu, bet gan visus - vienmēr norādiet tos skaidri. Atbildē tiek atdots arī secret - saglabājiet to uzreiz, GET /v1/webhook to vairs neatdod.
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"]}'5Sadaliet scenāriju pēc notikuma veida
Lauku event webhook ķermenī (call.completed, call.failed, call.no_answer, call.missed, message.sent, message.received) nošķiriet ar moduli Router vai filtru uz katra zara savienojuma. Paraksta Volai-Signature pārbaudi (HMAC-SHA256 pār {t}.{rawBody} ar jūsu secret) pievienojiet pēc precīzās formulas lapā /docs/webhooky - jutīgā scenārijā (maksājumi, ieraksti grāmatvedībā) to nevajadzētu izlaist.
Ko ar to varēsit izdarīt
Iterator sūta SMS visam kontaktu sarakstam
Modulis Iterator kontaktu masīvu (piemēram, no Google Sheets vai JSON masīva) sadala atsevišķos ierakstos, un HTTP modulis katram izsauc POST /v1/messages - parasti kopīgs paziņojums vai atgādinājums visai klientu grupai vienlaikus.
Filtrs uz savienojuma izlemj, kam zvanīt
Make ļauj ievietot nosacījumu tieši uz savienojuma starp moduļiem - filtrs izlaiž tikai rindas, kas atbilst nosacījumam (piemēram, tikšanās ir rīt un klients vēl nav apstiprinājis), un tikai tās nonāk HTTP modulī ar POST /v1/calls.
Kļūdu apstrādātājs uztver neizdevušos zvanu
Pievienojiet kļūdu apstrādes zaru ar direktīvu Ignore HTTP modulim, kas izsauc /v1/calls - atsevišķu neizdevušos zvanu (piemēram, nederīgu numuru) var ierakstīt tabulā vai nosūtīt uz Slack manuālai apstrādei, un viss scenārijs neapstājas ar kļūdu.
Biežāk uzdotie jautājumi
- Vai Make marketplace ir sava volai lietotne?
- Pagaidām nav - pietiek ar vispārīgajiem moduļiem HTTP un Webhooks, kas Make ir vienmēr pieejami. Sava lietotne Make ir saistīta ar Make Technology Partner Program, kuru mēs vēl nevirzām.
- Cik operāciju patērē scenārijs ar diviem HTTP moduļiem?
- Katra moduļa izpilde skaitās kā viena operācija - scenārijs, kas izsauc
/v1/messagesun pēc tam/v1/calls, vienā izpildē patērē aptuveni divas līdz trīs operācijas atkarībā no tā, cik moduļu ir pa vidu. Operāciju limitu nosaka jūsu Make abonements, nevis volai. - Kā pievienot kļūdu apstrādātāju HTTP modulim, lai viens neizdevies zvans neapturētu visu scenāriju?
- Ar peles labo pogu noklikšķiniet uz HTTP moduļa un pievienojiet kļūdu apstrādes zaru. Tajā izvēlieties direktīvu Ignore - scenārijs kļūdu ignorē un turpina, it kā modulis nebūtu atdevis neko. Ja nākamajiem moduļiem vajadzīga aizstājējvērtība trūkstošās izvades vietā, izmantojiet Resume ar savu rezerves izvadi. Break lietojiet tikai tad, ja izpilde jāapstādina uzreiz un vēlāk jāatkārto manuāli vai automātiski.
- Kāpēc Custom webhook uzreiz atbild `Accepted`, pirms scenārijs ir pabeigts?
- Tā Custom webhook modulis darbojas pēc noklusējuma - saņemšanu apstiprina ar statusu 200 un tekstu
Acceptednekavējoties, un scenārijs pēc tam turpinās fonā. Izsaucējam (šeit volai) vajag tikai šo 200 dažu sekunžu laikā - un tas ir izpildīts. - Kāpēc HTTP modulis pēc POST /v1/calls uzreiz turpina, lai gan zvans vēl nav beidzies?
POST /v1/callszvanu tikai sāk un atdod tāid- sinhroni, acumirklī. Vai zvans patiešām savienojās, tika pabeigts vai neizdevās, kļūst zināms tikai vēlāk ar webhookcall.completed/call.failed/call.no_answer/call.missed. Scenārijam nav jāgaida vai jāaptaujā - pietiek pie šī rezultāta pieslēgt iepriekš aprakstīto moduli Custom webhook.
Izmēģiniet uzreiz
Reģistrējieties un pirmie 50 kr ir uz mūsu rēķina.