Gå til indholdet
REST API

SMS og opkald direkte fra et Make-scenarie

Make kalder volai REST API via det generelle HTTP-modul - fra scenariet kan der sendes SMS, startes opkald via en stemmeagent, og resultatet kommer tilbage som webhook.

Kom i gang med den native connector

volai-connectoren er tilgængelig via invitation. Godkendelse i Makes offentlige appkatalog er stadig i gang.

1Forbind kontoen og læs saldoen

Åbn Make-invitationen, føj volai til organisationen, og indsæt Get balance i et scenarie. Gem en nøgle fra API og MCP i forbindelsen. Run once med kun dette modul læser saldoen og sender intet.

2Vælg et eksempel og kontrollér resultatet

Start med Watch events, call.completed og samme forbindelse for at skrive resultater til CRM. Tilføj kun Get a call, og tilknyt data.id til Call ID. Triggeren administrerer et selvstændigt abonnement og verificerer hændelsen via det autentificerede API; PUT /v1/webhook bliver ikke overskrevet. Brug event_id mod dubletter i CRM. Scenariet foretager ingen opkald og sender ingen SMS; kontrollér et resultat fra normal opkaldsaktivitet. Vælg message.received og Get a message for SMS; nummeret skal kunne modtage SMS. Triggere venter på en ny hændelse fra normal aktivitet; de afspiller ikke historiske registreringer igen.

3Tilføj først derefter en betalt handling

SMS, opkald og talebeskeder bruger saldo efter priserne; automatiseringsplatformen afregner egne kørsler efter sin plan. Kontrollér modtager, nødvendigt nummer/agent og fejlhåndtering før aktivering. Tilknyt Idempotency Key til et stabilt hændelses-ID som order-42-sms. Genbrug nøglen ved gentagelser af samme handling, og brug en ny til en ny handling. En accepteret anmodning bekræfter hverken levering eller et vellykket opkald.

Manuelt alternativ med HTTP og Webhooks

1Gør nøglen klar som forbindelse

I modulet HTTP > Make a request tilføjes headeren Authorization med værdien Bearer vk_TVUJ_KLIC (nøglen findes i portalen under AI-assistent). Gem den som en genanvendelig forbindelse, så den ikke skal skrives ind i hvert modul for sig.

2Send SMS fra scenariet

Tilføj et modul HTTP > Make a request: metode POST, URL https://volai.cz/v1/messages, body af typen Raw (JSON) med felterne to og body - værdierne kan roligt mappes fra det foregående moduls bundle (en tabelrække, en webhook) i stedet for at blive skrevet af. Slå Parse response til, så priceHal (prisen i heller for alle segmenter) og segments fra svaret straks bliver foldet ud i bundlen til videre mapping - uden det fås kun rå tekst, og der skulle tilføjes et separat Parse JSON-modul. Ved tekst med danske og andre særlige tegn bliver der flere segmenter end ved en ren ASCII-besked.

json
{
  "to": "+420777123456",
  "body": "Din bestilling er klar til afhentning."
}

3Start et opkald via stemmeagenten

Tilføj endnu et modul HTTP > Make a request: POST https://volai.cz/v1/calls, body Raw (JSON) med to og agentId for en eksisterende stemmeagent - agenten skal have tildelt et eget nummer, ellers ender forespørgslen med fejlen agent_no_number. Feltet to skrives som regel ikke i hånden, men mappes fra det foregående moduls bundle (for eksempel et telefonnummer fra en Google Sheets-række) - klik i feltet, og vælg variablen i menuen. Også her er Parse response nyttig: den folder id på det startede opkald ud i bundlen, så det kan mappes videre uden et særskilt Parse JSON-modul. Modulet starter kun opkaldet - det faktiske resultat (gennemført, ikke besvaret, fejlet) fås først fra webhooken i næste trin.

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

4Modtag hændelser via en verificeret vej

Til hændelser bruges den native opsætning med Watch events ovenfor, som verificerer hver hændelse via API. En Custom webhook i Make verificerer ikke afsenderen alene; de oprindelige bytes, der kræves til HMAC, kan ikke sikkert genskabes fra parset JSON. En egen modtager kan bygges ud fra webhook-dokumentationen, og signaturen skal verificeres på egen server før behandling. PUT /v1/webhook erstatter kontoens ældre konfiguration med en enkelt webhook; den skal ikke bruges til at forbinde hvert ekstra scenarie.

Hvad den kan bruges til

Iterator sender SMS til en hel liste af kontakter

Modulet Iterator folder et array af kontakter (for eksempel fra Google Sheets eller et JSON-array) ud i enkeltposter, og HTTP-modulet kalder så POST /v1/messages for hver især - typisk en samlet meddelelse eller påmindelse til en hel gruppe kunder på én gang.

Filter på forbindelsen afgør, hvem der skal ringes op

Make kan placere en betingelse direkte på forbindelsen mellem moduler - filteret lader kun de rækker passere, der opfylder betingelsen (for eksempel at aftalen er i morgen, og kunden endnu ikke har bekræftet), og kun dem sender videre til HTTP-modulet med POST /v1/calls.

Error handler fanger et mislykket opkald

Tilføj en error handler-route med direktivet Ignore på HTTP-modulet, der kalder /v1/calls - et enkelt mislykket opkald (for eksempel et ugyldigt nummer) kan så skrives til en tabel eller sendes til Slack til manuel opfølgning, uden at hele scenariet fejler.

Ofte stillede spørgsmål

Findes der en egen volai-app i Make-marketplace?
Du kan installere volais connector til Make via en invitation. Den understøtter SMS, opkald, talebeskeder, læsehandlinger og automatiske udløsere for SMS- og opkaldshændelser. Forbindelsen er endnu ikke opført i Makes offentlige appkatalog. Følg trinnene med HTTP og Webhooks nedenfor for at sætte det op manuelt.
Hvor mange operationer bruger et scenarie med to HTTP-moduler?
Hver kørsel af et modul tæller som én operation - et scenarie, der kalder /v1/messages og derefter /v1/calls, bruger i størrelsesordenen to til tre operationer pr. kørsel, afhængigt af hvor mange moduler der ligger imellem. Grænsen for operationer sættes af Make-abonnementet, ikke af volai.
Hvordan sættes en error handler på HTTP-modulet, så ét mislykket opkald ikke stopper hele scenariet?
Højreklik på HTTP-modulet, tilføj en error handler, og vælg Ignore, så scenariet fortsætter. Resume leverer et erstatningsoutput, Break stopper kørslen.
Hvorfor returnerer Custom webhook `Accepted` med det samme, før scenariet er færdigt?
Sådan fungerer modulet: det bekræfter modtagelsen med status 200 med det samme, og scenariet kører færdigt i baggrunden. Den, der kalder (her volai), behøver blot få 200 inden for få sekunder.
Hvorfor fortsætter HTTP-modulet straks efter POST /v1/calls, selvom opkaldet endnu ikke er slut?
POST /v1/calls starter kun opkaldet og returnerer dets id med det samme. Resultatet kommer senere via webhooken call.completed, call.failed, call.no_answer eller call.missed.

Prøv det med det samme

Opret en konto, og de første 15 kr. i saldo er på os.