SendGrid

  # Integração com SendGrid 

## Visão geral

O sendgrid é uma integração que permite que um chatbot Botpress envie e-mails através da API SendGrid .

## Configuração

### Autenticando seu domíniosendgrid

1. Faça login no painel de controle do SendGrid sendgrid
2. Na barra de navegação à esquerda, abra o submenu "Configurações" e clique em "Autenticação do remetente"
3. Na parte central direita da tela, clique no botão "Get Started" (somente autenticação de primeiro domínio)
   - (autenticação do segundo domínio ou mais) Perto do canto inferior esquerdo, na secção "Autenticação de domínio", clique em "Autenticar o seu domínio"
4. Selecione o fornecedor do seu domínio. Se o fornecedor não estiver listado, escolha "I'm Not Sure" (Não tenho a certeza) (É mais fácil do que a opção "Other host")
   - Também testado com domínios SquareSpace
5. No campo "From Domain", introduza o seu domínio (por exemplo,Botpress.com")
6. Adicione os registos DNS no portal do seu fornecedor de domínios (por exemplo, Cloudflare, GoDaddy, SquareSpace, etc.)
7. Marque "I've added these records" (Eu adicionei estes registos) e clique em "Verify" (Verificar) e aguarde que SendGrid confirme que foi verificado.
   - Se ainda for exibido um erro, apesar de adicionar corretamente os registros DNS "CNAME" ao seu provedor de domínio, tente remover o sufixo do domínio da chave do host. (por exemplo, "em1234botpress.com" > "em1234")
8. Agora está pronto para enviar e-mails com o seu domínio. Feliz envio de correio eletrónico!

### Adquirir uma chave APIsendgrid

1. Faça login no painel de controle do SendGrid sendgrid
2. Na barra de navegação à esquerda, abra o submenu "Configurações" e clique em "Chaves de API"
3. No canto superior direito, clique em "Criar chave de API"
4. Dê um nome à chave
5. Conceda permissões à chave com "Full Access" (Acesso total) ou, se utilizar "Restricted Access" (Acesso restrito), selecione o seguinte
   - "Mail Send" (Acesso total)
6. Clique em "Create & View" (Criar e visualizar)

### Configurar Webhookswebhook

1. Faça login no painel de controle do SendGrid sendgrid
2. Na barra de navegação à esquerda, abra o submenu "Configurações" e clique em "Configurações de e-mail"
3. Em Configurações de e-mail, clique em "Webhooks de evento"
4. Na parte central direita do ecrã, clique em "Create new webhook" (Criar novo webhook)
5. (Opcional) Dê ao webhook um "Friendly Name" (nome amigável) (por exemplo,Botpress Bot")
6. Copie o URL do webhook da configuração de integração Botpress e cole-o no campo "Post URL" do Sendgrid
7. Selecione as "Actions to be posted" (Acções a publicar), estes serão os eventos que a integração Botpress irá receber.
   1. Nota: Esta integração ainda não suporta todos os eventos
8. (Opcional, mas recomendado) Ativar a "Verificação de assinatura"
   1. Se tiver ativado esta opção, quando o webhook estiver guardado, clique na engrenagem do webhook e clique em "editar"
   2. Copie a "Chave de verificação" do Sendgrid e cole-a no campoWebhook Chave de verificação doWebhook " da configuração de integração Botpress 
9. Clique em "Salvar" e você estará pronto para usar os eventos no seu bot Botpress 

## Notas secundárias

A implementação atual está limitada apenas ao envio de emails de texto rico [markdown](https://spec.commonmark.org/0.31.2/), embora isto venha a ser expandido no futuro.

## Recursos

- https://www.twilio.com/docs/sendgrid/for-developers
- https://www.twilio.com/docs/sendgrid/api-reference
- https://www.twilio.com/docs/sendgrid/ui/account-and-settings/api-keys
- https://www.twilio.com/docs/sendgrid/ui/account-and-settings/how-to-set-up-domain-authentication