Integrazione con la REST API: agenti e dati nei tuoi sistemi

Tutto ciò che si trova nella console è disponibile tramite una REST API, così puoi usare gli agenti nel tuo sito web, nella tua app mobile, nel CRM o nel contact center, e inviare dati automaticamente.

1. Crea una chiave

Nella console, apri API & keys, assegna alla chiave un nome che indichi dove viene usata (ad es. mobile-app-prod) e clicca su Create key. Copiala subito: viene salvata solo un'impronta, quindi non potrà più essere visualizzata. Conservala nei segreti del tuo server, mai in un sito web o in un'app scaricabile dai clienti.

2. Richiama un agente

curl https://servicebuddy.com/api/v1/agents/auto/runs \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Where is my order 1004?"}]}'

• auto consente al router di scegliere l'agente; in alternativa, usa una chiave specifica come personal-shopper.
• Aggiungi "stream": true per ricevere la risposta token per token (server-sent events), insieme a eventi su prodotti, negozi e resi che puoi visualizzare come schede.

3. Invia dati

curl https://servicebuddy.com/api/v1/datasets -H "Authorization: Bearer $API_KEY" \
  -F entity=product -F [email protected]

Il file viene mappato automaticamente ed elaborato. Controlla lo stato di avanzamento con GET /api/v1/datasets/{id}.

Endpoint

Revoca di una chiave

Clicca su Revoke accanto alla chiave. Le chiamate con quella chiave si interrompono immediatamente.