# Zapier + Instatus

Source: https://instatus.com/help/pt-br/integrations/zapier

Conecte a Instatus a mais de 8.000 apps usando o Zapier para automatizar seus fluxos de gestão de incidentes.

1. Acesse a [Instatus no Zapier](https://zapier.com/apps/instatus/integrations)
2. Clique em **Connect Instatus to 8,000+ apps** para adicionar a Instatus à sua conta do Zapier
3. Quando for pedida a autenticação, pegue sua chave de API nas [configurações de desenvolvedor da Instatus](https://dashboard.instatus.com/developer) e cole-a no Zapier

![Integração da Instatus com o Zapier](https://instatus.com/help/integrations/zapier-1.png)

## Gatilhos

### Novo incidente ou atualização de incidente

Dispara quando um novo incidente é criado ou quando um incidente existente é atualizado. Use isso para avisar seu time, registrar incidentes em planilhas, abrir tickets em outras ferramentas e mais.

**Configuração**

- **Project**: selecione qual página de status da Instatus será monitorada em busca de incidentes

**Dados do gatilho**

O gatilho fornece os seguintes dados, que você pode usar nas etapas seguintes do Zap:

- `id` - ID único do incidente
- `type` - `CREATE` (novo incidente) ou `UPDATE` (atualização de incidente)
- `name` - nome/título do incidente
- `status` - status atual do incidente (`INVESTIGATING`, `IDENTIFIED`, `MONITORING`, `RESOLVED`)
- `started` - quando o incidente começou
- `resolved` - quando o incidente foi resolvido (se aplicável)
- `duration` - duração do incidente em segundos (se aplicável)
- `impact` - nível de impacto (`OPERATIONAL`, `UNDERMAINTENANCE`, `DEGRADEDPERFORMANCE`, `PARTIALOUTAGE`, `MAJOROUTAGE`)
- `components` - lista dos componentes afetados (cada um com `id`, `name`, `status`)
- `updates` - lista das atualizações do incidente (cada uma com `id`, `status`, `started`, `message`)

## Ações

Para configurar uma ação da Instatus, comece escolhendo o projeto da Instatus (página de status) com que quer trabalhar. Se seu projeto não aparecer na lista, você pode informar o ID da página manualmente — veja as instruções na seção [Solução de problemas](#não-encontra-seu-projeto-na-lista).

Depois de selecionar um projeto, aparecem campos adicionais para configurar a ação.

![Configuração da ação no Zapier](https://instatus.com/help/integrations/zapier-config.png)

### Criar incidente

Crie um novo incidente na Instatus a partir de gatilhos em outros apps. Use isso para criar incidentes na página de status automaticamente a partir de ferramentas de monitoramento, sistemas de tickets ou qualquer outro app do Zapier.

**Configuração**

- **Project** (obrigatório) - selecione em qual página de status da Instatus o incidente será criado
- **Status** (obrigatório) - status do incidente: `INVESTIGATING`, `IDENTIFIED`, `MONITORING`, `RESOLVED`
- **Title** (obrigatório) - o título/nome do incidente
- **Description** - mensagem descrevendo o incidente
- **Affected Components** - selecione quais componentes são afetados
- **Components Status** - status dos componentes afetados (por exemplo, `OPERATIONAL`, `DEGRADEDPERFORMANCE`, `PARTIALOUTAGE`, `MAJOROUTAGE`)
- **Started On** - quando o incidente começou (o padrão é agora)
- **Publish incident to status page** - se o incidente fica visível na sua página de status pública
- **Notify subscribers about the incident** - se as notificações são enviadas aos assinantes da sua página de status

## Exemplos de uso

- **Registrar incidentes no Google Sheets**: mantenha um histórico de todos os incidentes para relatórios e análises
- **Criar registros em bases do Notion**: adicione os incidentes automaticamente ao workspace do Notion do seu time para acompanhamento
- **Criar incidentes a partir de issues do GitHub**: abra um incidente na Instatus quando um bug crítico for reportado no GitHub
- **Sincronizar com o Airtable**: monte painéis e relatórios de incidentes personalizados no Airtable

Tudo pronto! Comece a montar seus Zaps.

## Solução de problemas

### Não encontra seu projeto na lista

Se sua página de status não aparecer na lista de projetos, você pode encontrar o ID da página manualmente:

1. Acesse sua página de status no [painel da Instatus](https://dashboard.instatus.com)
2. Clique com o botão direito no seu projeto, no canto superior esquerdo, para abrir o menu
3. Clique em **Copy Project ID**

![Copiar o ID da página](https://instatus.com/help/copy-id.png)

4. Selecione o valor **Custom** na lista de projetos do Zapier e cole o ID da sua página

![Projeto personalizado no Zapier](https://instatus.com/help/integrations/zapier-custom-id.png)

### O gatilho não dispara

- Confirme que seu Zap está ligado no Zapier
- Confira se você selecionou o projeto certo na configuração do gatilho
- Verifique se os incidentes estão mesmo sendo criados ou atualizados na página de status selecionada
- Teste o gatilho manualmente no Zapier para conferir a conexão (clique no botão **Test Run** e escolha um incidente da lista)

![Teste de execução no Zapier](https://instatus.com/help/integrations/zapier-test-run.png)

### Erros de autenticação

- Confirme que sua chave de API está correta. Você pode gerá-la novamente nas [configurações de desenvolvedor](https://dashboard.instatus.com/developer)
- Certifique-se de colar a chave de API completa, sem espaços extras

### Os componentes não aparecem

- Confirme que sua página de status tem componentes configurados
- Clique em **Refresh fields** no Zapier para carregar os componentes mais recentes da sua página de status

![Atualizar campos no Zapier](https://instatus.com/help/integrations/zapier-refresh.png)

Precisa de mais ajuda? Fale com a gente em [support@instatus.com](mailto:support@instatus.com).