Treceți la conținut
Primiți 50 kr
REST API

Agent vocal cu număr ceh în aplicația dumneavoastră Lovable

Lovable construiește aplicații pe React, cu backend Supabase - apelarea REST API-ului volai aparține de aceea serverului, într-o singură Edge Function, nu aplicației din browser.

1Salvați cheia API ca secret Supabase

În proiectul Supabase pe care Lovable l-a creat pentru aplicație, adăugați variabila de mediu VOLAI_API_KEY cu valoarea cheii dumneavoastră (portal, secțiunea API și MCP). Nu o puneți niciodată în codul de frontend și nu o încărcați în repozitoriu - oricine ar vedea-o ar putea cheltui credit în numele dumneavoastră.

2Apelați volai dintr-o Edge Function

Creați o Edge Function care primește cererea din aplicație și numai EA apelează https://volai.cz/v1/messages, cu antetul Authorization: Bearer ${VOLAI_API_KEY}. În același fel se poate construi o funcție pentru POST /v1/calls (apel prin agentul vocal).

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 });
});

3Apelați funcția din interfața cu utilizatorul

Dintr-o componentă a aplicației apelați Edge Function prin supabase.functions.invoke(...) - cheia rămâne doar pe server, aplicația trimite numai to și textul mesajului.

typescript
const { data, error } = await supabase.functions.invoke("send-sms", {
  body: { to: "+420777123456", body: "Comanda dumneavoastra este pregatita pentru ridicare." },
});

4Setați un webhook, ca aplicația să afle rezultatul apelului

Creați o a doua Edge Function care primește evenimentul (call.completed, call.failed, call.no_answer, call.missed, message.sent, message.received) și îl scrie într-un tabel Supabase - de acolo îl citește aplicația prin Realtime sau printr-o interogare obișnuită. Salvați adresa prin PUT /v1/webhook; un câmp events gol ar însemna absolut toate evenimentele, deci este mai bine să le enumerați. În mod implicit Supabase lasă să intre într-o Edge Function doar cererile cu o cheie în antetul Authorization, altfel returnează 401: pentru această funcție dezactivați verify_jwt și verificați evenimentul prin semnătura Volai-Signature sau trimiteți cheia într-un antet propriu, prin câmpul headers.

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"]}'

5Opțional: lăsați Lovable AI să adauge singur volai

La construirea aplicației, Lovable poate folosi și un instrument extern printr-un server MCP propriu (Custom MCP servers / Custom connectors în setările de integrări). Adresa serverului este https://volai.cz/mcp, autentificarea se face cu Authorization: Bearer vk_TVUJ_KLIC - butoanele exacte din interfața Lovable se schimbă mai repede decât această pagină, procedura actuală o găsiți în docs.lovable.dev/integrations.

Ce puteți face cu el

SMS de confirmare după o comandă sau o rezervare

Un magazin online sau o aplicație de rezervări creată în Lovable apelează după plată propria Edge Function, care trimite un SMS de confirmare cu detaliile comenzii.

Un agent vocal care răspunde la telefon în numele aplicației

Aplicația cumpără un număr de telefon și creează agentul prin REST (sau îl configurați manual în portal) - clienții aplicației sună apoi la un număr ceh real, nu la o platformă străină.

Lovable AI adaugă singur apelurile și SMS-urile în aplicație

La construirea aplicației lăsați Lovable AI să folosească volai prin Custom MCP - descrieți funcția în cuvinte („adaugă un buton care sună clientul”), iar AI-ul alege singur instrumentul potrivit.

Întrebări frecvente

Pot apela API-ul volai direct din codul de frontend al aplicației?
Nu. Cheia API nu are ce căuta în browser - oricine ar deschide consola pentru dezvoltatori ar putea să o vadă și să vă cheltuiască creditul. Folosiți întotdeauna o Edge Function sau altă rută de server care păstrează cheia doar în backend.
Există un conector Lovable nativ pentru volai?
Deocamdată nu - conectorii nativi din Lovable sunt întotdeauna parteneriate (așa funcționează, de exemplu, cel pentru ElevenLabs). Astăzi calea duce prin REST dintr-o Edge Function sau prin serverul generic Custom MCP descris mai sus.
Cum află aplicația că apelul s-a încheiat, fără interogări continue?
Scrieți webhook-ul call.completed într-un tabel Supabase dintr-o Edge Function, iar aplicația citește modificarea prin Supabase Realtime - fără polling.
Cât va costa funcționarea aplicației?
Se aplică aceleași tarife ca în lista de prețuri, fără supraprețuri pentru Lovable: SMS 1.36 CZK (~EUR 0.06), apel efectuat 0.92 CZK/min (~EUR 0.04), agentul vocal costă suplimentar 2.50 CZK/min (~EUR 0.10). Lista completă de prețuri se află la /cenik.

Încercați chiar acum

Înregistrați-vă și primii 50 kr sunt din partea noastră.

Primiți 50 kr creditDeschideți documentația