> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.userbot.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.userbot.ai/_mcp/server.

# Supporto partner

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](/api-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](https://help.userbot.ai/guida-allinizio/setup-e-accesso-a-userbot).

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](https://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:

| Risorsa                                                                                                | Contenuto                                                                               |
| ------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------- |
| **developers.userbot.ai** (qui)                                                                        | API REST, webhook, quickstart, sicurezza — per chi integra via codice                   |
| [Help Center](https://help.userbot.ai/)                                                                | Guide prodotto: agenti, flussi, canali, integrazioni — per chi configura in piattaforma |
| [Help Center — Integrazione sistemi esterni](https://help.userbot.ai/integrazione-con-sistemi-esterni) | Panoramica integrazioni e configurazione webhook in dashboard                           |
| [userbot.ai](https://userbot.ai)                                                                       | Panoramica 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](/welcome) — panoramica dell'integrazione e del flusso REST + webhook
2. [Quickstart](/quickstart) — prima chiamata API per verificare credenziali e `session`
3. [Tutorial: prima integrazione](/tutorial-prima-integrazione) — REST + webhook + HMAC end-to-end
4. [API Reference](/api-overview) — 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](/api-rate-limiting) — 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:

* [Sicurezza dei Dati in Userbot](https://help.userbot.ai/sicurezza-e-conformita/sicurezza-dei-dati-in-userbot)
* [Come Userbot è conforme al GDPR](https://help.userbot.ai/sicurezza-e-conformita/come-userbot-e-conforme-al-gdpr)
* [Sicurezza e best practice](/sicurezza-best-practice) — guida integrazione partner con checklist production-ready