Renvoyer

  # Intégration du renvoi

## Aperçu

`@botpresshub/resend` est une intégration qui permet à un chatbot Botpress d'envoyer des emails via l'API Resend.

## Configuration

### Authentification de votre domaine (https://resend.com/domains)

1. Se connecter au tableau de bord Resend (https://resend.com/)
2. Dans la barre de navigation à gauche, cliquez sur "Domaines"
3. En haut à droite, cliquez sur "Ajouter un domaine"
4. Dans le champ "Nom", entrez votre domaine (par exempleBotpress.com").
5. (Optionnel) Sélectionnez la région du serveur la plus proche de votre base d'utilisateurs.
6. (Optionnel) Personnaliser le chemin de retour (Seulement recommandé si vous savez ce que cela fait)
7. Cliquez sur "Ajouter un domaine" (sous "Options avancées")
8. Ajoutez les enregistrements DNS dans le portail de votre fournisseur de domaine (par exemple SquareSpace, GoDaddy, etc.).
   1. Bien que l'enregistrement DMARC soit facultatif, il est recommandé pour se protéger contre l'usurpation ou l'utilisation non autorisée du domaine.
9. Cliquez sur "J'ai ajouté les enregistrements" et attendez que chaque statut soit marqué comme "Vérifié"
10. Vous êtes maintenant prêt à envoyer des emails avec votre domaine. Bon envoi d'emails !

### Acquisition d'une clé API (https://resend.com/api-keys)

1. Connectez-vous au tableau de bord Resend (https://resend.com/)
2. Dans la barre de navigation à gauche, cliquez sur "Clés API"
3. En haut à droite, cliquez sur "Créer une clé API"
4. Donnez un nom à la clé et accordez-lui un "accès d'envoi"
   1. En option, choisissez les domaines par lesquels vous souhaitez que la clé envoie des e-mails.
5. Cliquez sur "Ajouter" pour générer la clé API
6. Copiez la clé API résultante dans un endroit sûr, car elle ne sera affichée qu'une seule fois.

### Configuration des Webhooks (https://resend.com/webhooks)

1. Connectez-vous au tableau de bord Resend (https://resend.com/)
2. Dans la barre de navigation à gauche, cliquez sur "Webhooks"
3. En haut à droite, cliquez sur "Add Webhook" (ajouter un Webhook)
4. Copiez l'URL du webhook depuis la configuration de l'intégration de Botpress et collez-la dans le champ de saisie "Endpoint URL" de Resend.
5. Sélectionnez les événements du webhook que vous souhaitez écouter
6. Cliquez sur "Ajouter" (en dessous de la section "Sélectionner les événements à écouter")
7) (Facultatif, mais recommandé) Copiez le "Signing Secret" de Resend et collez-le dans leWebhook Signing Secret" de la configuration de l'intégration Botpress 
8. Maintenant votre bot est prêt à écouter les événements de Resend.

## Notes annexes

L'implémentation actuelle est limitée à l'envoi d'emails en texte enrichi [markdown](https://spec.commonmark.org/0.31.2/), mais cette fonctionnalité sera étendue à l'avenir.

## Ressources

- 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