Procedimentos normalmente são acionados pela intenção do cliente — Fin compara o que o cliente diz com os critérios "Quando usar" do procedimento. Gatilhos proativos permitem iniciar um procedimento fora da conversa: quando o cliente clica em um elemento específico do seu site ou quando um sistema externo chama a API do Intercom.
Nota: Gatilhos proativos de procedimento estão em Beta. Contate seu gerente de conta para acesso.
Experiência do cliente
Quando um gatilho proativo é acionado:
Fin envia a primeira mensagem que você configurou para o cliente
O procedimento só começa após o cliente responder
Se o cliente nunca responder, a conversa é encerrada com um resultado Pendente
Importante: Um resultado Pendente não conta para sua taxa de resolução. Gatilhos proativos são feitos para alcance — métricas de resolução só se aplicam quando o cliente interage e o procedimento é executado.
Roteamento após a primeira resposta do cliente
Acionar um procedimento não garante que ele será executado. Após a primeira resposta do cliente, Fin avalia a mensagem e decide como proceder:
Fin segue o procedimento acionado se nenhuma das condições abaixo se aplicar
Fin deixa o procedimento de lado se a resposta pedir um agente humano
Fin deixa o procedimento de lado se a resposta corresponder à intenção de outro procedimento
Fin deixa o procedimento de lado se puder responder com confiança à resposta usando conteúdo de ajuda
Nota: Projete seus fluxos proativos com isso em mente — um procedimento acionado não é garantido de executar se a primeira resposta do cliente levar Fin para outra direção.
Configure um gatilho de clique em elemento do site
Gatilhos de clique em elemento do site disparam quando um cliente clica em um botão, link ou outro elemento específico do seu site.
Importante: Este gatilho está disponível apenas na web (Messenger). O Messenger deve estar instalado na página onde o elemento aparece.
Abra o procedimento no editor
Vá para Quando usar (gatilho) > Gatilhos proativos
Selecione Clique em elemento do site
Digite a URL da página e clique em Navegar e selecionar para escolher o elemento
Configure a primeira mensagem do Fin — isso é obrigatório e é o que Fin envia quando o gatilho dispara
Configure as configurações de implantação para o que acontece após o término do procedimento
Configure um gatilho de chamada de API
Gatilhos de chamada de API permitem que um sistema externo inicie um procedimento programaticamente.
Nota: Este gatilho suporta canais web (Messenger) e email. O padrão é web se nenhum canal for especificado.
Pré-requisitos
Um app Developer Hub com um token de acesso
O token deve ter o escopo write_conversations
Importante: Armazene seu token de acesso no servidor. Nunca o inclua no código do cliente onde pode ser exposto.
Fazendo a chamada API
Abra o procedimento no editor
Vá para Quando usar (gatilho) > Gatilhos proativos
Selecione Chamada de API — a URL do endpoint específico do procedimento é mostrada aqui
Envie uma requisição POST para essa URL com os cabeçalhos e corpo abaixo
Configure a primeira mensagem do Fin (obrigatório)
Configure as configurações de implantação para após o término do procedimento
Cabeçalhos obrigatórios:
Authorization: Bearer {your-access-token}
Intercom-Version: UnstableImportante: O cabeçalho Intercom-Version: Unstable é obrigatório. Este endpoint ainda não está em uma versão estável da API — omitir este cabeçalho fará a requisição falhar.
Corpo da requisição:
{
"user": {
"id": "your-user-id"
}
}Resposta de sucesso
Uma requisição bem-sucedida retorna conversation_id e procedure_id:
{
"conversation_id": "...",
"procedure_id": "..."
}