Esta integração fornece acesso abrangente à API da Canny para gerir publicações e comentários nos seus quadros de pedidos de funcionalidades. # Recursos ## Acções **Gestão de pós-gerenciamento:** - **Criar publicação**: Criar novos posts nos seus quadros Canny - **Obter publicação**: Obter informações detalhadas sobre uma publicação específica - **Listar publicações**: Listar publicações com opções de filtragem e paginação - Atualizar publicação**: Modificar as mensagens existentes (título, detalhes, ETA, etc.) - **Eliminar mensagem**: Remover mensagens dos seus quadros **Gestão de comentários:** - **Criar Comentário**: Adicionar comentários aos posts - **Obter Comentário**: Recuperar detalhes do comentário - **Listar Comentários**: Listar comentários com opções de filtragem - **Delete Comment**: Remover comentários ## Canais **Canal de publicações:** - Trata de conversas em que as mensagens são o tópico principal e os comentários são respostas - Quando os utilizadores enviam mensagens em conversas, estas são automaticamente criadas como comentários na publicação associada ## Eventos **Suporte a Webhook :** - Cria automaticamente conversas quando são criadas novas mensagens no Canny - Adiciona mensagens às conversas quando novos comentários são publicados - A primeira mensagem em cada conversa é o conteúdo da publicação, e as mensagens subsequentes são comentários # Configuração Para usar essa integração, você precisará de: 1. **Chave de API**: A sua chave de API da Canny (obtenha-a nas definições da sua conta Canny) # ID do autor As publicações e os comentários aparecerão comoBotpress", a menos que forneça um `authorId` específico. Para utilizar um autor diferente, forneça um `authorId` de um utilizador existente no seu espaço de trabalho Canny. Pode encontrar IDs de utilizador disponíveis utilizando a ação "Listar utilizadores". # Exemplos de utilização ## Configurar Webhooks Configure webhooks na sua conta Canny para apontar para o ponto final de integração Botpress para sincronizar automaticamente publicações e comentários como conversas. # Fluxo de conversas 1. **Criação de post**: Quando um novo post é criado no Canny, é iniciada uma nova conversa no Botpress 2. **Respostas de comentários**: Quando os utilizadores respondem na conversa, são criados novos comentários no post original 3. **Gestão de tópicos**: Cada mensagem torna-se um tópico de conversação com comentários como mensagens