Intercom HITL

  # 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.