> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Integração com o PagerDuty
> Conecte o PagerDuty ao Devin para acionar automações a partir de incidentes e dar às sessões do Devin acesso a incidentes, serviços e escalas de plantão.
Conecte o PagerDuty para que o Devin comece a trabalhar assim que um incidente for aberto. Incidentes do PagerDuty acionam [automações](/pt-BR/product-guides/automations) do Devin, e o MCP server do PagerDuty dá às sessões do Devin acesso a incidentes, serviços e escalas de plantão.
## Configurando a integração
1. No PagerDuty, acesse **Integrations > API Access Keys** e clique em "Create New API Key". Crie uma chave **General Access** com acesso total e copie-a. Tokens de API de usuário não são aceitos.
2. Na sua conta do Devin em app.devin.ai, acesse [Configurações > Connections > PagerDuty](https://app.devin.ai/settings/connections/pagerduty) e clique em "Connect".
3. Selecione a sua **região de API** (US ou EU) e informe:
* **E-mail do ator**: o usuário do PagerDuty a quem as notas e atualizações de incidentes do Devin serão atribuídas. Recomendamos um service user dedicado.
* **Chave de API REST General Access**: a chave que você criou na etapa 1.
4. Clique em "Connect". O Devin cria automaticamente uma assinatura de webhook no PagerDuty para poder receber eventos de incidentes.
## Configure as assinaturas de webhook
Ao conectar, o Devin cria uma assinatura de webhook no nível da conta no PagerDuty. Ela envia estes eventos para o Devin:
* `incident.triggered`
* `incident.acknowledged`
* `incident.resolved`
* `incident.priority_updated`
* `incident.reassigned`
* `incident.service_updated`
A seção **Webhook** da página de configurações mostra o status da assinatura. Se a configuração automática falhar, clique em "Retry webhook setup" ou adicione o webhook manualmente:
1. Na seção **Webhook**, clique em "Add webhook" e copie a URL do webhook.
2. No PagerDuty, acesse **Integrations > Generic Webhooks (v3)** e adicione um webhook que aponte para essa URL com escopo **Account**.
3. Selecione os tipos de evento de incidente listados acima.
4. Copie o signing secret que o PagerDuty exibe uma única vez, cole-o no Devin e clique em "Save".
Desconectar o PagerDuty interrompe os eventos de incidente e exclui a assinatura de webhook criada pelo Devin. Isso não remove o MCP server do PagerDuty.
O MCP server do PagerDuty autentica cada membro via OAuth. O PagerDuty não oferece suporte ao registro automático de OAuth client, portanto um admin precisa registrar um OAuth app no PagerDuty e fornecer ao Devin o client ID e o secret correspondentes.
1. Em [Configurações > Connections > PagerDuty](https://app.devin.ai/settings/connections/pagerduty), clique em "Set up with OAuth" na seção **MCP server**. Copie a **OAuth callback URL** exibida na página de configuração.
2. No PagerDuty, acesse **Integrations > App Registration** e clique em "New App". Informe um nome, como `Devin`, e selecione **OAuth 2.0**.
3. Selecione **Scoped OAuth** e adicione a OAuth callback URL do Devin como uma **Redirect URL**.
4. Em permission scopes, selecione todos os escopos de **Read Access**. O Devin não precisa de acesso de escrita.
5. Copie o valor de **Selected Permission Scope**. Você vai informá-lo ao instalar o MCP server.
6. Registre o app e, em seguida, copie o **client ID** e o **client secret**.
### Instale o MCP server
1. Na página de configuração do Devin, selecione a **server URL** da sua região: Estados Unidos (`mcp.pagerduty.com`) ou União Europeia (`mcp.eu.pagerduty.com`).
2. Informe o **OAuth client ID** e o **OAuth client secret** do seu app do PagerDuty.
3. Cole o valor de **Selected Permission Scope** do seu app do PagerDuty no campo **OAuth scope**.
4. Salve a instalação.
O acesso ao MCP do PagerDuty é sempre pessoal. O Devin nunca usa um token compartilhado da organização para isso. Cada membro precisa conectar sua própria conta de usuário do PagerDuty para que o Devin possa usar as tools do PagerDuty em suas sessões.
Além da integração no nível da organização, cada membro da equipe vincula sua própria conta do PagerDuty à sua conta do Devin. Isso permite que o Devin use o MCP server do PagerDuty como aquele membro. Isso também é necessário para criar automações do PagerDuty.
Para conectar sua conta de usuário, acesse [Personal Connections](https://app.devin.ai/account/connections), clique em "Connect" ao lado de PagerDuty e aprove o acesso no PagerDuty. Use um usuário do PagerDuty pertencente à conta do PagerDuty que sua organização conectou.
O Devin começa a trabalhar nos incidentes do PagerDuty por meio de [automações](/pt-BR/product-guides/automations). Depois que o PagerDuty estiver conectado, não é necessário configurar um webhook separado para cada automação.
1. Acesse **Automations** e crie uma nova automação.
2. Adicione um trigger, escolha **PagerDuty** e selecione um evento:
* **Incident triggered**: um novo incidente é aberto.
* **Incident acknowledged**: alguém reconhece um incidente.
* **Incident resolved**: um incidente é resolvido.
* **Incident updated**: a prioridade, a atribuição ou o serviço de um incidente muda.
3. Se quiser, adicione condições para restringir quais incidentes se aplicam:
* **Service**, **Team** e **Priority**: as opções são carregadas da sua conta do PagerDuty.
* **Urgency** (`high` ou `low`) e **Status**.
* **Title**, **Escalation policy** e **Assignee**.
* **Change** (`priority`, `assignment` ou `service`): apenas para **Incident updated**.
4. Adicione uma ação **Start session** com instruções para o Devin e salve.
Por exemplo, para investigar incidentes de alta urgência no seu serviço de checkout, use o evento **Incident triggered** com as condições **Service** igual a `checkout-api` e **Urgency** igual a `high`. Depois, adicione um prompt como: "Investigue este incidente. Verifique os deploys recentes e os logs de erro do checkout-api e identifique a provável causa raiz."
Para criar ou editar uma automação com um trigger do PagerDuty, é preciso primeiro [conectar sua conta de usuário do PagerDuty](#connecting-your-pagerduty-user-account). Seu usuário do PagerDuty deve pertencer à conta do PagerDuty que sua organização conectou.