Reenviar

  # Reenviar integração

## Visão geral

O `@botpresshub/resend` é uma integração que permite que um chatbot Botpress envie e-mails através da API Resend.

## Configuração

### Autenticando seu domínio (https://resend.com/domains)

1. Inicie sessão no painel de controlo do Reenvio (https://resend.com/)
2. Na barra de navegação à esquerda, clique em "Domínios"
3. No canto superior direito, clique em "Adicionar domínio"
4. No campo "Name", introduza o seu domínio (por exemplo,Botpress.com")
5. (Opcional) Selecione a região do servidor mais próxima da sua base de utilizadores
6. (Opcional) Personalizar o caminho de retorno (Apenas recomendado se souberes o que isto faz)
7. Clique em "Adicionar domínio" (abaixo de "Opções avançadas")
8. Adicione os registos DNS no portal do seu fornecedor de domínios (por exemplo, SquareSpace, GoDaddy, etc.)
   1. Embora o registo DMARC seja opcional, é recomendado para proteger contra falsificação/utilização não autorizada do domínio
9. Clique em "I've added the records" (Adicionei os registos) e aguarde que cada estado seja marcado como "Verified" (Verificado)
10. Agora está pronto para enviar e-mails com o seu domínio. Feliz envio de correio eletrónico!

### Adquirindo uma chave de API (https://resend.com/api-keys)

1. Inicie sessão no painel de controlo do Reenvio (https://resend.com/)
2. Na barra de navegação à esquerda, clique em "Chaves de API"
3. No canto superior direito, clique em "Criar chave de API"
4. Dê um nome à chave e conceda-lhe "Sending Access" (Acesso de envio)
   1. Opcionalmente, escolha os domínios através dos quais pretende que a chave envie mensagens de correio eletrónico
5. Clique em "Adicionar" para gerar a chave da API
6. Copie a chave de API resultante para um local seguro, pois ela só será exibida uma vez

### Configurando Webhooks (https://resend.com/webhooks)

1. Inicie sessão no painel de controlo do Reenvio (https://resend.com/)
2. Na barra de navegação à esquerda, clique em "Webhooks"
3. No canto superior direito, clique em "Adicionar Webhook"
4. Copie o URL do webhook da configuração de integração Botpress e cole-o no campo de entrada "Endpoint URL" do Resend
5. Selecione os eventos webhook que pretende ouvir
6. Clique em "Add" (abaixo da secção "Select events to listen")
7. (Opcional, mas recomendado) Copie o "Signing Secret" (Segredo de assinatura) do Resend e cole-o noWebhook Signing Secret" (Segredo de assinatura doWebhook ) da configuração de integração Botpress 
8. Agora seu bot está pronto para ouvir os eventos do Resend

## Notas secundárias

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

## Recursos

- https://resend.com/docs/introduction
- https://resend.com/docs/dashboard/domains/introduction
- https://resend.com/docs/dashboard/api-keys/introduction
- https://resend.com/docs/dashboard/emails/send-test-emails