# Integração Intercom HITL Esta integração permite que Botpress use Intercom como um provedor HITL (Human in the Loop). As mensagens do bot aparecerão no Intercom, e as respostas do agente serão enviadas de volta para o bot. ## Caraterísticas - Integração perfeita entre Botpress e Intercom - Sincronização de mensagens em tempo real - Suporte para mensagens de texto - Gestão automática de sessões de conversação - Tratamento de eventos Webhook - Atribuição de agentes e gestão de conversas ## Configuração A integração requer a seguinte configuração: - `accessToken`: Seu token de acesso ao Intercom (necessário para autenticação da API) ## Configuração do aplicativo Intercom para integração com Botpress Este guia orienta-o na instalação e configuração do Intercom para permitir a integração com o seu chatbot Botpress . ### Instruções passo a passo #### 1. Criar um aplicativo Intercom * Navegue atéintercomintercom * Inicie sessão na sua conta Intercom * Vá para **Apps** no hub do desenvolvedor * Clique em **"Criar aplicativo "** * Introduza o nome da sua aplicação (por exemplo,Botpress HITL Integration") * Clique em **"Criar aplicativo "** #### 2. Copiar o código de acesso * No painel de controlo da aplicação, vá para **Autenticação** * Copie o **Token de acesso** apresentado na secção Token de acesso * Na sua **configuração de integração do Botpress Intercom , cole este Token de acesso #### 3. Configurar Webhooks ##### a. Webhook de eventos de conversação Webhook * Aceda a **Webhooks** no painel de controlo da sua aplicação * Clique em **"Adicionar Webhook"** * Defina o Webhook URL** para o seu Botpress Intercom integration webhook URL** * Subscrever apenas estes eventos * `conversation.admin.assigned` * `conversation.admin.closed` * `conversation.admin.replied` * Clique em **"Guardar Webhook"** ### Resumo da configuração necessária Botpress * **Token de acesso**: Da autenticação do aplicativo Intercom * URL do Webhook : Fornecido pelo Botpress ## Utilização 1. Configure a integração com o seu Token de Acesso Intercom 2. Iniciar uma sessão de conversação utilizando a ação `startHitl` 3. As mensagens do bot aparecerão nas conversas Intercom 4. As respostas do agente no Intercom serão enviadas de volta para o bot 5. O estado da conversa é gerido automaticamente entre Botpress e Intercom **Nota:** Ao iniciar uma sessão HITL, se o e-mail do utilizador não existir como contacto no Intercom, será criado automaticamente um novo contacto. Se o e-mail já existir, o contacto existente será utilizado para o processo HITL. ## Suporte Para obter suporte, entre em contato com a equipe Botpress ou consulte aIntercom Documentação da APIIntercom ]intercom. ## Solução de problemas ### Problemas comuns 1. **O Webhook não está a receber eventos**: Certifique-se de que o URL do webhook está acessível publicamente e configurado corretamente 2. **Erros de autenticação**: Verifique se o seu Token de Acesso está correto e tem as permissões necessárias 3. **As mensagens não estão a ser sincronizadas**: Verifique se a conversa foi criada corretamente e se o contacto existe no Intercom ### Modo de depuração Active o registo de depuração na sua configuração Botpress para resolver problemas de integração.