Canny

  Cette intégration offre un accès complet à l'API de Canny pour la gestion des messages et des commentaires dans vos tableaux de demandes de fonctionnalités.

# Fonctionnalités

## Actions

**Gestion des postes:**

- **Créer un message** : Créez de nouveaux messages dans vos tableaux Canny
- Obtenir un message** : Récupérer des informations détaillées sur un message spécifique
- Lister les messages** : Liste des messages avec options de filtrage et de pagination
- Mettre à jour un message** : Modifier les messages existants (titre, détails, heure d'arrivée prévue, etc.)
- Supprimer un message** : Supprimez les messages de vos tableaux

**Gestion des commentaires:**

- **Créer un commentaire** : Ajouter des commentaires aux messages
- Obtenir un commentaire** : Récupérer les détails d'un commentaire
- Liste des commentaires** : Liste des commentaires avec options de filtrage
- Supprimer un commentaire** : Supprimer des commentaires

## Canaux

**Posts Channel:**

- Gère les conversations dans lesquelles les messages sont le sujet principal et les commentaires sont des réponses.
- Lorsque les utilisateurs envoient des messages dans les conversations, ils sont automatiquement créés en tant que commentaires sur l'article associé.

## Événements

Webhook Support:**

- Crée automatiquement des conversations lorsque de nouveaux messages sont créés dans Canny
- Ajoute des messages aux conversations lorsque de nouveaux commentaires sont postés
- Le premier message de chaque conversation est le contenu de l'article, et les messages suivants sont des commentaires.

# Configuration

Pour utiliser cette intégration, vous aurez besoin de :

1. **Clé API** : Votre clé API Canny (vous pouvez l'obtenir à partir des paramètres de votre compte Canny)

# ID de l'auteur

Les messages et les commentaires apparaîtront commeBotpress" à moins que vous ne fournissiez un `authorId` spécifique.

Pour utiliser un auteur différent, fournissez un `authorId` d'un utilisateur existant dans votre espace de travail Canny. Vous pouvez trouver les identifiants disponibles en utilisant l'action "List Users".

# Exemples d'utilisation

## Mise en place de Webhooks

Configurez les webhooks dans votre compte Canny pour pointer vers votre point de terminaison d'intégration Botpress afin de synchroniser automatiquement les messages et les commentaires en tant que conversations.

# Flux de conversation

1. **Création d'un message** : Lorsqu'un nouveau post est créé dans Canny, une nouvelle conversation est lancée dans Botpress
.
2. **Réponses aux commentaires** : Lorsque les utilisateurs répondent dans la conversation, de nouveaux commentaires sont créés sur l'article original.
3. **Gestion des fils de conversation** : Chaque message devient un fil de conversation avec des commentaires en tant que messages.