> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrazione PagerDuty

> Collega PagerDuty a Devin per attivare automazioni dagli incident e dare alle sessioni Devin accesso a incident, servizi e turni di reperibilità.

Collega PagerDuty per consentire a Devin di iniziare a lavorare non appena viene generato un incident. Gli incident di PagerDuty attivano le [automazioni](/it/product-guides/automations) di Devin e il server MCP di PagerDuty offre alle sessioni Devin accesso a incident, servizi e turni di reperibilità.

<div id="setting-up-the-integration">
  ## Configurazione dell'integrazione
</div>

1. In PagerDuty, vai su **Integrations > API Access Keys** e fai clic su "Create New API Key". Crea una key di tipo **General Access** con accesso completo e copiala. I token API utente non sono accettati.
2. Nel tuo account Devin su app.devin.ai, vai su [Settings > Connections > PagerDuty](https://app.devin.ai/settings/connections/pagerduty) e fai clic su "Connect".
3. Seleziona la tua **API region** (US o EU), quindi inserisci:
   * **Actor email**: l'utente PagerDuty a cui vengono attribuite le note e gli aggiornamenti sugli incident di Devin. Consigliamo di usare un utente di servizio dedicato.
   * **General Access REST API key**: la key creata al passaggio 1.
4. Fai clic su "Connect". Devin crea automaticamente una sottoscrizione webhook in PagerDuty per poter ricevere gli eventi relativi agli incident.

<div id="configure-webhook-subscriptions">
  ## Configurare le sottoscrizioni webhook
</div>

Quando ti connetti, Devin crea in PagerDuty una sottoscrizione webhook a livello di account, che invia a Devin questi eventi:

* `incident.triggered`
* `incident.acknowledged`
* `incident.resolved`
* `incident.priority_updated`
* `incident.reassigned`
* `incident.service_updated`

La sezione **Webhook** della pagina delle impostazioni mostra lo stato della sottoscrizione. Se la configurazione automatica non riesce, fai clic su "Retry webhook setup" oppure aggiungi il webhook manualmente:

1. Nella sezione **Webhook**, fai clic su "Add webhook" e copia l'URL del webhook.
2. In PagerDuty, vai su **Integrations > Generic Webhooks (v3)** e aggiungi un webhook che punti a quell'URL con ambito **Account**.
3. Seleziona i tipi di evento incident elencati sopra.
4. Copia il signing secret che PagerDuty mostra una sola volta, incollalo in Devin e fai clic su "Save".

<Note>
  Disconnettendo PagerDuty si interrompono gli eventi incident e viene eliminata la sottoscrizione webhook creata da Devin. Questa operazione non rimuove l'MCP server di PagerDuty.
</Note>

<div id="setting-up-the-pagerduty-mcp-server">
  ## Configurare l'server MCP di PagerDuty
</div>

L'server MCP di PagerDuty autentica ogni member tramite OAuth. PagerDuty non supporta la registrazione automatica degli OAuth client, quindi è un admin a registrare un'OAuth app in PagerDuty e a fornire a Devin il relativo client ID e secret.

<div id="register-an-oauth-app-in-pagerduty">
  ### Registra una OAuth app in PagerDuty
</div>

1. In [Settings > Connections > PagerDuty](https://app.devin.ai/settings/connections/pagerduty), fai clic su "Set up with OAuth" nella sezione **server MCP**. Copia l'**OAuth callback URL** mostrato nella pagina di configurazione.
2. In PagerDuty, vai su **Integrations > App Registration** e fai clic su "New App". Inserisci un nome, ad esempio `Devin`, e seleziona **OAuth 2.0**.
3. Seleziona **Scoped OAuth** e aggiungi l'OAuth callback URL di Devin come **Redirect URL**.
4. Tra i permission scopes, seleziona tutti gli ambiti **Read Access**: Devin non necessita dell'accesso in scrittura.
5. Copia il valore **Selected Permission Scope**: dovrai inserirlo durante l'installazione del server MCP.
6. Registra l'app, quindi copia il **client ID** e il **client secret**.

<div id="install-the-mcp-server">
  ### Installa il server MCP
</div>

1. Nella pagina di configurazione di Devin, seleziona il **server URL** per la tua regione: Stati Uniti (`mcp.pagerduty.com`) o Unione Europea (`mcp.eu.pagerduty.com`).
2. Inserisci l'**OAuth client ID** e l'**OAuth client secret** della tua app PagerDuty.
3. Incolla il valore **Selected Permission Scope** della tua app PagerDuty nel campo **OAuth scope**.
4. Salva l'installazione.

<Note>
  L'accesso MCP a PagerDuty è sempre personale: Devin non utilizza mai un token condiviso a livello di organizzazione. Ogni membro deve collegare il proprio account utente PagerDuty affinché Devin possa usare gli strumenti di PagerDuty nelle sue sessioni.
</Note>

<div id="connecting-your-pagerduty-user-account">
  ## Collegare il tuo account utente PagerDuty
</div>

Oltre all'integrazione a livello di organizzazione, ogni membro del team collega il proprio account PagerDuty al proprio account Devin. In questo modo Devin può usare il server MCP di PagerDuty con l'identità di quel membro. È inoltre necessario per creare automazioni PagerDuty.

Per collegare il tuo account utente, vai su [Personal Connections](https://app.devin.ai/account/connections), fai clic su "Connect" accanto a PagerDuty e approva l'accesso in PagerDuty. Usa un utente PagerDuty appartenente all'account PagerDuty collegato dalla tua organizzazione.

<div id="triggering-devin-from-pagerduty">
  ## Attivare Devin da PagerDuty
</div>

Devin inizia a lavorare sugli incident di PagerDuty tramite le [automazioni](/it/product-guides/automations). Una volta collegato PagerDuty, non è necessario configurare un webhook separato per ogni automazione.

1. Vai su **automazione** e crea una nuova automazione.
2. Aggiungi un trigger, scegli **PagerDuty** e seleziona un evento:
   * **Incident triggered**: viene aperto un nuovo incident.
   * **Incident acknowledged**: qualcuno prende in carico un incident.
   * **Incident resolved**: un incident viene risolto.
   * **Incident updated**: cambiano la priorità, l'assegnazione o il servizio di un incident.
3. Facoltativamente, aggiungi delle condizioni per restringere gli incident corrispondenti:
   * **Service**, **Team** e **Priority**: le opzioni vengono caricate dal tuo account PagerDuty.
   * **Urgency** (`high` o `low`) e **Status**.
   * **Title**, **Escalation policy** e **Assignee**.
   * **Change** (`priority`, `assignment` o `service`): solo per **Incident updated**.
4. Aggiungi un'azione **Start session** con le istruzioni per Devin e salva.

Ad esempio, per analizzare gli incident ad alta urgenza sul tuo servizio di checkout, usa l'evento **Incident triggered** con le condizioni **Service** uguale a `checkout-api` e **Urgency** uguale a `high`. Poi aggiungi un prompt come: «Analizza questo incident. Controlla i deploy recenti e i log degli errori di checkout-api e individua la probabile causa principale».

<Note>
  Per creare o modificare un'automazione con un trigger PagerDuty, devi prima [collegare il tuo account utente PagerDuty](#connecting-your-pagerduty-user-account). Il tuo utente PagerDuty deve appartenere all'account PagerDuty collegato dalla tua organizzazione.
</Note>
