Integrazioni API
Grip AI può chiamare le tue API durante le conversazioni per recuperare o inviare dati in tempo reale.Quando Usare
Usa le API quando l’assistente deve:- Verificare lo stato di un ordine
- Cercare un cliente nel CRM
- Creare un ticket di supporto
- Controllare disponibilità prodotto
- Aggiornare dati in tempo reale
Setup Base
1. Configura Endpoint in Dashboard
Vai in Strumenti → Integrazioni API → Nuova Integrazione2. Autenticazione
Scegli il metodo appropriato:- API Key
- Bearer Token
- Basic Auth
3. Definisci Parametri
Specifica quali dati l’AI deve raccogliere prima di chiamare l’API:4. Istruzioni nel Prompt
Aggiungi al system prompt:Esempi Pratici
GET Request - Recupera Dati
POST Request - Crea Dati
Gestione Errori
L’AI deve gestire risposte di errore:| Status Code | Comportamento AI |
|---|---|
| 200-299 | Successo - comunica risultato |
| 404 | ”Non trovo questo ordine. Può verificare il numero?“ |
| 401/403 | ”Problema tecnico. La faccio richiamare.” |
| 500 | ”Sistema momentaneamente non disponibile. Riprovi tra poco.” |
| Timeout | ”Il sistema sta impiegando troppo tempo. Preferisce attendere?” |
Configurazione Avanzata
Parametri Dinamici
Retry Policy
Response Mapping
Specifica come interpretare la risposta:Best Practices
Timeout Appropriati
Timeout Appropriati
Imposta timeout realistici (2-5 secondi). API troppo lente peggiorano l’esperienza.
Validazione Input
Validazione Input
Fai validare i parametri all’AI prima di chiamare (es. formato numero ordine).
Fallback
Fallback
Dai sempre alternative se API fallisce (callback, email, numero diretto).
Security
Security
- Usa HTTPS sempre
- API key con minimi permessi necessari
- Rate limiting sul tuo server
Troubleshooting
API non risponde
API non risponde
Check:
- URL corretto?
- Firewall blocca IP Grip?
- Autenticazione corretta?
- Test con curl/Postman
Autenticazione fallisce
Autenticazione fallisce
- Verifica API key corretta (no spazi)
- Header name esatto (case-sensitive)
- Token non scaduto
Dati non corretti
Dati non corretti
- Controlla response nei log Grip
- Verifica response mapping
- Valida formato JSON