Pređi na sadržaj
Pitaj.io

Eksterni REST API i Webhook Pozivi

Za napredne poslovne procese, agentu su potrebni podaci iz vaših internih softverskih sistema: stanje zaliha u skladištu, status pošiljke u kurirskoj službi, provjera termina u kalendaru ili validacija korisničkog naloga.

Pitaj.io API Akcije omogućavaju agentu da tokom razgovora izvuče parametre (npr. broj narudžbe), pozove vaš eksterni REST API endpoint i sintetizuje odgovor kupcu.

Kako funkcioniše API cjevovod?

[Korisnik] "Gdje se nalazi moja narudžba br. ORD-8921?"
    ↓
[AI Agent] Prepoznaje parametar: { "order_id": "ORD-8921" }
    ↓
[Pitaj.io Backend] Šalje siguran HTTPS POST ka vašem serveru:
    URL: https://api.vasaservis.com/v1/orders/ORD-8921/status
    Headers: Authorization: Bearer secret_token_xyz
    ↓
[Vaš API] Vraća JSON: { "status": "U dostavi", "kurir": "Express One", "ocekivani_datum": "Sutra do 14h" }
    ↓
[AI Agent] Formulira odgovor:
    "Vaša narudžba ORD-8921 je trenutno u dostavi putem Express One kurira i očekuje se sutra do 14:00h!"

Podešavanje API Akcije

  1. Otvorite Akcije → + Nova Akcija
    Odaberite tip REST API Webhook.

  2. Definišite HTTP metodu i Endpoint URL
    Odaberite metodu (GET, POST, PUT) i unesite adresu vašeg servera:
    https://api.vasadomena.com/v1/narudzba-status

  3. Podesite zaglavlja (Headers) i Autentifikaciju
    Dodajte sigurnosna zaglavlja, npr:

    • Authorization: Bearer vas_tajni_api_kljuc
    • Content-Type: application/json

  4. Konfigurišite parametre koje agent treba izvući
    Definišite parametre koje AI model mora prepoznati iz korisničke poruke:

    • order_id (Tip: Tekst, Opis: Broj narudžbe koji kupac navodi)
    • email (Tip: Email, Opis: Email adresa kupca)

  5. Definišite JSON tijelo zahtjeva (Request Body)
    Koristite dinamičke varijable unutar JSON tijela (npr. orderNumber: "{{order_id}}", customerEmail: "{{email}}").

  6. Mapiranje odgovora (Response Instruction)
    Uputite agenta kako da interpretira odgovor vašeg servera:
    “Objasni kupcu trenutni status pošiljke, navedi naziv kurira i datum očekivane isporuke.”

Primjer JSON tijela zahtjeva (Request Body)

{
  "orderNumber": "{{order_id}}",
  "customerEmail": "{{email}}",
  "channel": "pitaj_widget"
}

Sigurnost i zaštita podataka

HTTPS Enkripcija

Svi pozivi se obavljaju isključivo preko TLS 1.3 enkriptovanih konekcija sa verifikovanim SSL certifikatima.

Zaštita API ključeva

Vaši Bearer tokeni i tajni ključevi se čuvaju kriptovani u našem trezoru i nikada nisu izloženi u klijentskom JavaScript kodu widgeta.