Liigu sisu juurde
Saage 50 kr
REST API

Hääleagent Tšehhi numbriga teie Lovable'i rakenduses

Lovable ehitab rakendused Reactiga ja Supabase'i taustasüsteemiga - volai REST API kutsumine kuulub seetõttu serverisse, ühte Edge Function'isse, mitte brauseris töötavasse rakendusse.

1Salvestage API võti Supabase'i secretina

Supabase'i projektis, mille Lovable teie rakenduse jaoks lõi, lisage keskkonnamuutuja VOLAI_API_KEY oma võtme väärtusega (portaal, jaotis API ja MCP). Ärge pange seda kunagi frontendi koodi ega hoidlasse - igaüks, kes seda näeks, saaks teie nimel saldot kulutada.

2Kutsuge volai Edge Function'ist

Looge Edge Function, mis võtab rakendusest päringu vastu ja alles TEMA kutsub https://volai.cz/v1/messages päisega Authorization: Bearer ${VOLAI_API_KEY}. Sama mustriga saab ehitada funktsiooni päringule POST /v1/calls (kõne hääleagendi kaudu).

typescript
// supabase/functions/send-sms/index.ts
Deno.serve(async (req) => {
  const { to, body } = await req.json();

  const res = await fetch("https://volai.cz/v1/messages", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${Deno.env.get("VOLAI_API_KEY")}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ to, body }),
  });

  return new Response(await res.text(), { status: res.status });
});

3Kutsuge funktsioon kasutajaliidesest

Rakenduse komponendist kutsuge Edge Function välja supabase.functions.invoke(...) abil - võti jääb ainult serverisse, rakendus saadab vaid to ja sõnumi teksti.

typescript
const { data, error } = await supabase.functions.invoke("send-sms", {
  body: { to: "+420777123456", body: "Tellimus on valmis." },
});

4Seadistage webhook, et rakendus saaks kõne tulemuse teada

Looge teine Edge Function, mis võtab vastu sündmuse (call.completed, call.failed, call.no_answer, call.missed, message.sent, message.received) ja kirjutab selle Supabase'i tabelisse - sealt loeb rakendus selle Realtime'i või tavapäringuga. Salvestage aadress päringuga PUT /v1/webhook; tühi massiiv events tähendaks absoluutselt kõiki sündmusi, loetlege parem vajalikud. Supabase laseb vaikimisi Edge Function'isse ainult päringuid, mille päises Authorization on võti, ja vastab muidu 401: lülitage selle funktsiooni puhul verify_jwt välja ja kontrollige sündmust allkirjaga Volai-Signature või saatke võti oma päises välja headers kaudu.

bash
curl -X PUT https://volai.cz/v1/webhook \
  -H "Authorization: Bearer vk_TVUJ_KLIC" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://tvuj-projekt.supabase.co/functions/v1/volai-webhook", "events": ["call.completed", "message.sent"]}'

5Valikuline: laske Lovable'i AI-l volai ise lisada

Lovable oskab rakenduse ehitamisel kasutada ka kolmanda poole tööriista oma MCP-serveri kaudu (Custom MCP servers / Custom connectors integratsiooniseadetes). Serveri aadress on https://volai.cz/mcp, autentimine Authorization: Bearer vk_TVUJ_KLIC - täpsed nupud Lovable'i kasutajaliideses muutuvad kiiremini, kui see leht jõuab järgi, seega vaadake kehtivaid samme aadressilt docs.lovable.dev/integrations.

Mida sellega teha saab

Kinnitus-SMS pärast tellimust või broneeringut

Lovable'iga ehitatud e-pood või broneerimisrakendus kutsub pärast makset oma Edge Function'i, mis saadab tellimuse üksikasjadega kinnitus-SMS-i.

Hääleagent, kes võtab rakenduse eest telefoni vastu

Rakendus ostab telefoninumbri ja loob agendi REST-i kaudu (või seadistate need käsitsi portaalis) - rakenduse kliendid helistavad siis päris Tšehhi numbrile, mitte võõrale platvormile.

Lovable'i AI lisab helistamise ja SMS-id rakendusse ise

Laske rakenduse ehitamisel Lovable'i AI-l volai'ni jõuda Custom MCP kaudu - kirjeldage funktsiooni sõnadega („lisa nupp, mis helistab kliendile“) ja AI valib sobiva tööriista ise.

Korduma kippuvad küsimused

Kas ma võin volai API-t kutsuda otse rakenduse frontendi koodist?
Ei. API võti ei kuulu brauserisse - igaüks, kes avab arendajakonsooli, võiks seda näha ja teie saldot kulutada. Minge alati läbi Edge Function'i või muu serveripoolse marsruudi, mis hoiab võtit ainult taustasüsteemis.
Kas Lovable'ile on olemas volai natiivne konnektor?
Veel mitte - Lovable'i natiivsed konnektorid on alati partnerlused (nii töötab näiteks ElevenLabsi oma). Täna kulgeb tee REST-i kaudu Edge Function'ist või ülalkirjeldatud üldise Custom MCP serveri kaudu.
Kuidas rakendus teab, et kõne lõppes, ilma pideva pärimiseta?
Kirjutage webhook call.completed Edge Function'ist Supabase'i tabelisse ja lugege muudatust rakenduses Supabase Realtime'i kaudu - ilma pollimiseta.
Kui palju rakenduse käitamine maksab?
Samad hinnad mis hinnakirjas, Lovable'i kasutamise eest lisatasu pole: SMS 1,36 kr (≈ 0,06 EUR), väljuv kõne 0,92 kr/min (≈ 0,04 EUR), hääleagent lisaks 2,50 kr/min (≈ 0,10 EUR). Täpne hinnakiri on aadressil /cenik.

Proovige kohe järele

Registreeruge ja esimesed 50 kr on meie kingitus.

Hankige 50 kr krediitiAvage dokumentatsioon