Risorse

Supporto partner

Credenziali, assistenza tecnica e risorse
View as Markdown

Questa pagina raccoglie le informazioni per partner B2B che integrano le API Userbot in CRM, ERP, portali e sistemi interni. Che tu stia iniziando da zero o risolvendo un problema in produzione, qui trovi dove ottenere credenziali, quale documentazione consultare e come contattare il supporto.

Richiedere l’accesso alle API

Per integrare Userbot nel tuo stack servono tre elementi fondamentali:

  1. Un account Userbot con almeno un Agente AI configurato — la base su cui poggia tutta l’integrazione
  2. Un Access Token Bearer — generabile dalla dashboard; vedi Autenticazione
  3. La Secret Key dell’agente da integrare — in dashboard: Integrazioni → API Keys; identifica quale agente risponde alle tue chiamate (parametro bot_key nel path REST)

Per la creazione dell’account e la configurazione del primo agente, segui la procedura descritta nell’Help Center — Setup e accesso.

Se la tab Access Token non è visibile nelle impostazioni account, contatta il tuo referente Userbot per l’abilitazione API. Non tutti i piani includono l’accesso alle API di default.

Dashboard

Accedi alla piattaforma su my.userbot.ai con le credenziali ricevute via email.

Dalla dashboard puoi:

  • Configurare webhook — imposta l’URL del tuo endpoint e ottieni il Webhook Secret
  • Monitorare conversazioni — vedi chat in corso, performance degli agenti e metriche operative
  • Gestire agenti e flussi — configura knowledge base, canali e pipeline di automazione

La dashboard è il punto di controllo operativo; le API sono il modo programmatico di interagire con quanto configuri lì.

Documentazione di riferimento

Userbot ha più risorse documentali, ognuna con un focus diverso. Scegli in base a cosa ti serve:

RisorsaContenuto
developers.userbot.ai (qui)API REST, webhook, quickstart, sicurezza — per chi integra via codice
Help CenterGuide prodotto: agenti, flussi, canali, integrazioni — per chi configura in piattaforma
Help Center — Integrazione sistemi esterniPanoramica integrazioni e configurazione webhook in dashboard
userbot.aiPanoramica commerciale e casi d’uso — per decision maker e overview prodotto

Percorso consigliato per nuovi partner

Se è la prima volta che integri Userbot, segui questo ordine — ogni passo costruisce sul precedente:

  1. Benvenuto — panoramica dell’integrazione e del flusso REST + webhook
  2. Quickstart — prima chiamata API per verificare credenziali e session
  3. Tutorial: prima integrazione — REST + webhook + HMAC end-to-end
  4. API Reference — guide tecniche e reference OpenAPI/AsyncAPI interattiva

Segnalazione problemi API

In caso di problemi con le API — errori persistenti 5xx, webhook non consegnati, comportamenti inattesi — raccogli prima le informazioni utili al debug:

  1. Timestamp dell’incidente e, se applicabile, session / sessionId / eventId
  2. Status HTTP e body errore restituito dall’API
  3. Verifica di non aver superato i rate limit — a volte un 429 viene scambiato per un bug

Contatta poi il supporto tecnico Userbot tramite il canale definito nel contratto di partnership.

Non includere Access Token, Webhook Secret o dati personali nei ticket di supporto. Usa identificativi di sessione e evento — sono sufficienti per il debug e non espongono credenziali sensibili.

Sicurezza e conformità

Per policy su GDPR, gestione dati e sicurezza infrastrutturale: