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

# SendGrid

> Configure o SendGrid como provedor de email no Notifuse.

O Notifuse pode enviar emails pelo SendGrid.

## Configuração

Vá em **Configurações** → **Integrações**, clique em **Adicionar integração** e escolha **SendGrid** em **Envio de emails**. O formulário abre em tela cheia.

![Configurações do SendGrid](https://www.notifuse.com/docs/assets/screenshots/sendgrid_settings.png)

### Campos do formulário

| Campo         | Descrição                                    | Exemplo                                        |
| ------------- | -------------------------------------------- | ---------------------------------------------- |
| **Chave API** | Chave API do SendGrid com permissão de envio | `SG.xxxxxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx` |

### Lista de remetentes

Adicione os endereços de remetente verificados na sua conta SendGrid:

| Campo     | Descrição                      | Exemplo                  |
| --------- | ------------------------------ | ------------------------ |
| **Nome**  | Nome exibido do remetente      | `Support Team`           |
| **Email** | Endereço de email do remetente | `support@yourdomain.com` |

Os remetentes precisam estar verificados pelo Sender Authentication do SendGrid antes de você poder usá-los.

### Tipos de uso

Escolha o que esta integração SendGrid envia no menu **⋯** do card dela em **Configurações** → **Integrações** (**Usar para marketing**, **Usar para transacional**) ou no painel **Envio de emails** da mesma página:

| Opção                      | Descrição                                                | Exemplos                                                     |
| -------------------------- | -------------------------------------------------------- | ------------------------------------------------------------ |
| **Usar para transacional** | Emails gerados pelo sistema a partir de ações do usuário | Redefinição de senha, confirmação de pedido, avisos da conta |
| **Usar para marketing**    | Emails promocionais e newsletters enviados aos inscritos | Anúncios de produto, newsletters, campanhas promocionais     |

Escolha as duas opções para enviar todos os tipos de email pela mesma configuração do SendGrid.

### Webhooks

O Notifuse registra automaticamente os seguintes webhooks do SendGrid:

| Tipo de webhook | Descrição                         | Finalidade                                  |
| --------------- | --------------------------------- | ------------------------------------------- |
| **Delivered**   | Email entregue                    | Acompanhar as entregas                      |
| **Bounce**      | Email retornado                   | Monitorar os retornos                       |
| **Dropped**     | Email descartado antes da entrega | Acompanhar as falhas de entrega             |
| **Spam Report** | O destinatário denunciou abuso    | Tratar as denúncias de abuso                |
| **Deferred**    | Entrega do email adiada           | Acompanhar problemas temporários de entrega |

O Notifuse recebe esses eventos de entrega no momento em que acontecem.

## Pré-requisitos

Você precisa de:

1. Uma conta SendGrid ativa
2. Endereços de email ou domínios verificados pelo Sender Authentication do SendGrid
3. Uma chave API do SendGrid com a permissão **Mail Send** (ela começa com `SG.`)

## Como criar uma chave API

1. Entre na sua conta SendGrid
2. Vá em **Settings** → **API Keys**
3. Clique em **Create API Key**
4. Selecione **Restricted Access** e habilite:
   - **Mail Send** → Full Access
   - **Tracking** → Full Access (para os webhooks)
5. Copie a chave API gerada (ela começa com `SG.`)

## Teste

Clique em **Enviar um e-mail de teste** no topo do formulário da integração, ou em **Enviar teste** no card dela, para verificar a configuração.
