Procedimentos Fin permitem que você projete fluxos claros e repetíveis que guiam Fin no tratamento de consultas complexas. Você define a estrutura usando Etapas, amplia as habilidades do Fin com Ferramentas e molda seu comportamento com Orientação.
Seja coletando informações, ramificando lógica, conectando a sistemas externos ou passando para colegas, os Procedimentos dão controle total sobre como Fin lida com uma conversa do início ao fim.
Nota: Para criar Procedimentos você precisa ter a permissão "can manage workspace data".
Dica: Conecte-se com Especialistas da Comunidade e Arquitetos de Soluções Intercom em nosso Procedures Meetup Office Hours. Realizadas a cada duas semanas, essas sessões oferecem suporte prático em tempo real, incluindo Q&A ao vivo para ajudar você a configurar e otimizar seus Procedimentos Fin e conectores de Dados.
Comece agora
Para construir um novo Procedimento Fin, navegue até Fin AI Agent > Train > Procedures em seu workspace.
Clique em + Novo procedimento e escolha seu método preferido de criação:
Opção 1: Deixe a IA elaborar seu procedimento
Este é o método mais rápido se você já tem um processo em mente ou documentado.
Selecione Deixe a IA elaborar seu procedimento.
Escolha sua opção de ponto de partida 1: descreva seu processo ou opção 2: escolha um modelo:
Opção 1: Descreva seu processo: Escreva seu processo em linguagem natural ou cole instruções passo a passo existentes ou Procedimentos Operacionais Padrão (SOPs) diretamente na caixa de texto. Fin irá estruturá-los automaticamente em um formato de procedimento adequado para você. Selecione quais atributos e Data Connectors incluir como contexto — você pode escolher conectores específicos em vez de passar todos, e atributos agora atuam como contexto em vez de apenas espaços reservados.
Opção 2: Escolha um modelo: Selecione um modelo específico do setor (por exemplo, SaaS, Ecommerce, Fintech ou Gaming) e escolha um cenário comum, como "Cancelar ou pausar uma assinatura". Selecione quais atributos e Data Connectors incluir como contexto — você pode escolher conectores específicos em vez de passar todos, e atributos agora atuam como contexto em vez de apenas espaços reservados.
Nota: Há um limite de 5.000 caracteres para o campo de descrição em Deixe a IA elaborar seu procedimento.
Clique em Continuar. Fin então analisará sua entrada e fundamentará o rascunho no contexto do seu workspace, pesquisando suas conversas anteriores com clientes, documentação existente e Data Connectors.
Responda às perguntas de esclarecimento para ajudar Fin a detalhar a lógica e as instruções específicas. Embora sejam opcionais, fornecer essas informações garante um rascunho mais preciso.
Quando Fin gerar o rascunho, aparecerá um modal de feedback. Escolha Manter para aceitar o rascunho, Limpar para descartá-lo e começar de novo, ou Tentar novamente para regenerar.
Dica: Se você já tem instruções passo a passo ou um processo documentado, use Opção 1: Deixe a IA elaborar seu procedimento. Basta colar suas instruções existentes e deixar Fin estruturá-las em um formato de procedimento adequado — não é necessário formatar manualmente cada etapa. Você também pode elaborar seu caso de uso primeiro para identificar quais Data Connectors precisará configurar antes de entrar em produção.
Opção 2: Criar do zero
Use este método se quiser construir um Procedimento manualmente.
Selecione Criar do zero.
Nomeie seu procedimento e entre no editor para começar a adicionar etapas manualmente.
Nota: Evite usar caracteres especiais (como '|') nos títulos dos procedimentos. Eles podem causar erros no backend ao salvar. Use caracteres alfanuméricos padrão e mantenha os títulos claros e descritivos.
Informe ao Fin quando usar este procedimento
No topo do editor, você encontrará a seção Quando usar este procedimento. Isso é crucial para informar ao Fin exatamente quando utilizar este Procedimento. Para garantir que Fin dispare apenas quando pretendido, você deve fornecer uma lógica de gatilho clara e exemplos de conversas de alta qualidade. Esses dois componentes trabalham juntos para melhorar a confiabilidade e reduzir falsos positivos.
Nota: O campo de descrição tem um limite de 256 caracteres. Mantenha sua descrição concisa para evitar falhas ao salvar.
1. Escreva a lógica de 'Quando usar este Procedimento'
Descreva exatamente quando este procedimento deve (e não deve) começar. Um gatilho forte inclui critérios específicos e exclusões.
Exemplo de lógica de gatilho de alta qualidade:
Quando disparar este procedimento: Dispare este procedimento quando um cliente relatar que o software não está funcionando corretamente ou está se comportando de forma inesperada.
Critérios de inclusão (Disparar se):
O cliente descreve um problema técnico específico ou erro.
O cliente afirma que um recurso está quebrado.
O cliente menciona um bug, glitch ou mau funcionamento.
Critérios de exclusão (NÃO disparar se):
O cliente está solicitando um novo recurso.
O cliente está fazendo perguntas relacionadas à conta (por exemplo, redefinições de senha).
Gatilhos claros e abrangentes garantem que Fin ative seu procedimento para as intenções corretas do cliente e evitem disparos para consultas não relacionadas.
Como funciona o disparo do procedimento
Fin avalia cada mensagem do cliente para decidir se corresponde à descrição do gatilho do procedimento, o que significa que um procedimento não começará apenas porque uma conversa foi aberta. Ele começa quando Fin está confiante de que a intenção do cliente corresponde ao propósito do procedimento. Ao testar, envie uma mensagem que expresse claramente a intenção nas suas instruções “Quando usar este procedimento” em vez de uma mensagem inicial curta ou vaga.
2. Treine o Fin com exemplos
Depois de escrever sua lógica, forneça exemplos de conversas para o Fin.
Clique no botão Treinar Fin com exemplos.
Quando usar: Forneça exemplos de frases ou cenários onde este procedimento é apropriado.
Quando NÃO usar: Forneça exemplos de consultas semelhantes, mas não relacionadas, para evitar disparos falsos.
Esses exemplos são cruciais para treinar a IA a distinguir entre um "reset de senha" e "informações gerais sobre política de login".
Adicione instruções ao procedimento
Você pode dizer ao Fin o que fazer quando o procedimento for acionado escrevendo instruções. Além dessas instruções, você também pode adicionar controles determinísticos que dão mais poderes ao Fin - como condições, ou até ferramentas para permitir que o Fin acesse dados externos, atualize atributos.
Passos definem o fluxo. Você os adiciona digitando @ em uma nova linha.
Ferramentas dão poderes ao Fin (como verificar APIs). Você as adiciona digitando @ dentro de um passo de Instrução.
Recurso | O que faz | Quando usar |
Instrução | O bloco padrão. Instruções em linguagem natural simples. | Para quase tudo. "Peça ao cliente o e-mail dele." |
Condição | Adiciona lógica de ramificação (SE / SENÃO). | Use para caminhos principais, mutuamente exclusivos, que mudam significativamente o fluxo. Para pequenas variações ou esclarecimentos menores, use Instruções em linguagem natural em vez de ramificações. Isso mantém seus procedimentos mais simples e permite que a IA do Fin conduza a conversa de forma mais natural. Por exemplo, ramifique pelo canal atual para enviar uma mensagem diferente no WhatsApp vs. web, ou pelo papel do usuário para tratar leads e users de forma diferente. |
Executar subprocedimento | Executa um subprocedimento. | Para reutilizar um fluxo comum (por exemplo, "Verificar Identidade") sem reescrevê-lo, ou um fluxo complexo que você gostaria de ocultar do fluxo principal. |
Transferir para workflow | Encerra o Procedimento e passa o usuário para um Workflow. | Use isso para transferir para um Workflow reutilizável que você já criou, como um fluxo complexo de transferência, uma pesquisa de satisfação ou um caminho de roteamento especializado. |
Fim | Encerra o Procedimento imediatamente e retorna para o Fin. Cada passo de Fim tem uma mensagem final configurável onde você pode escrever uma mensagem personalizada, deixar em branco para não enviar nada, ou manter o padrão. | Use isso para parar um Procedimento assim que um objetivo específico ou condição lógica for atingida, garantindo que o Fin não continue seguindo os passos do procedimento. |
Chamar conector de dados | Busca dados ao vivo de apps conectados (Shopify, Stripe, etc.). | Dentro de um passo quando você precisar verificar o status de um pedido ou saldo. |
Ler um atributo | Consulta dados existentes do cliente. | Dentro de um passo para verificar o plano ou ID de um user. |
Atualizar um atributo | Salva informações que o cliente forneceu em um atributo | Dentro de um passo para lembrar uma resposta para depois. |
Transferir para equipe | Intencionalmente transfere a conversa para uma equipe ou colega de equipe. | Dentro de um passo quando o bot não consegue resolver o problema. |
Aguardar Webhook | Pausa o procedimento e espera que um sistema externo envie um callback antes do Fin retomar. Gera uma URL de callback única por execução do procedimento. | Dentro de um passo ao integrar com um sistema de terceiros que processa solicitações assincronamente — por exemplo, verificação de identidade, autorização de pagamento ou workflows de aprovação. Disponível em beta aberto: contate sua equipe de conta para solicitar acesso. |
Importante:
Sem aninhamento: Você não pode aninhar passos de Condição dentro de outras Condições.
Tipo único de lógica: Você não pode misturar código e condições em linguagem natural dentro de um único passo.
Atributos não suportados: Atributos como datas ou decimais não podem ser referenciados em condições atualmente.
Subprocedimentos
Reutilizar: Você pode reutilizar um subprocedimento várias vezes dentro do mesmo procedimento pai.
Escopo: Subprocedimentos são atualmente locais e não podem ser chamados por outros procedimentos não relacionados.
Transições para Workflows
Transferência unidirecional: Quando o Fin passa um cliente para um Workflow, o procedimento termina.
Sem retomada: O procedimento não será retomado mesmo após o Workflow ser concluído.
Trabalhando com Conectores de Dados
Escopo de atributo
As saídas do Conector de Dados estão disponíveis como saídas de passo dentro do Procedimento, mas não aparecerão como atributos de conversa no Inbox. Para persistir o valor retornado por um conector em um atributo de conversa, use um passo Handoff to workflow e defina o atributo dentro do Workflow — o Procedimento não será retomado após a transferência.
Sempre trate falhas do conector
Adicione um passo de Condição após cada chamada de Data Connector para lidar com erros e respostas vazias. Sem um fallback, Fin pode escalar inesperadamente se um conector falhar silenciosamente. Veja Solução de problemas em Fin Procedures e Data connectors para padrões comuns de falha e como usar status_code para tratamento avançado de erros.
As configurações de entrada do conector determinam o que Fin solicita aos clientes
Quando um Data Connector é configurado com campos de entrada obrigatórios — por exemplo, um Order ID — Fin solicitará ao cliente que forneça essa informação antes de executar a chamada do conector. Os campos específicos que Fin solicita são determinados pelas configurações de entrada do conector, não pelas instruções do procedimento.
Chamadas de conector e uso da resposta
Nota: Uma chamada de conector pode ser executada mesmo que os dados da resposta não sejam usados na resposta final que Fin envia ao cliente. Isso pode acontecer quando Fin chama um conector enquanto avalia uma lógica que acaba seguindo um caminho diferente. Sempre adicione tratamento de erros para falhas de conector, independentemente de você esperar que a resposta do conector seja exibida.
Saiba mais:
Nota: A partir de 12 de março de 2026, os handoffs configurados (usando @handoff) serão cobrados como resultados bem-sucedidos de handoff de Procedure. Saiba mais sobre Fin Outcomes e cobrança. Você não será cobrado pelo comportamento padrão de escalonamento do Fin (quando o cliente pede um humano, frustração detectada, loop repetitivo), Regras de Escalonamento ou Guidance em nível de workspace, ou um Procedure que não é concluído.
@Look up content
A ferramenta @Look up content direciona o Fin para buscar em seu Help Center ou knowledge base externa informações específicas durante uma conversa de procedimento. Use isso para instruir o Fin a referenciar conteúdo de suporte atualizado durante uma conversa de procedimento, em vez de usar texto estático.
Tipos de conteúdo suportados
Artigos públicos
Artigos privados (habilitados para AI Agent)
Documentos enviados
Fontes de conteúdo importadas ou sincronizadas
Documentos sincronizados pela web
Trechos de conteúdo
Requisitos importantes:
Verifique se a fonte de conteúdo ainda está sincronizada e ativa.
Garanta que o artigo esteja habilitado para AI agent: Para tornar um artigo público disponível, navegue até Knowledge, abra o artigo e use o painel Detalhes para alternar o seguinte:
Fin AI Agent: Esta configuração permite que a AI use o artigo ao responder aos clientes. Ela respeitará automaticamente quaisquer regras de público estabelecidas.
Nota: Content Lookup recupera apenas conteúdo de texto dos artigos. Imagens dentro dos artigos não são incluídas no que é retornado para o Fin, portanto o Fin não pode repassá-las em sua resposta.
Exemplos de casos de uso
Ecommerce
Em um procedimento de devolução ou reembolso, você pode direcionar o Fin para consultar sua política de devoluções mais recente em vez de codificá-la diretamente no fluxo.
Elegibilidade
Use um artigo interno de elegibilidade para ajudar o Fin a determinar se um usuário se qualifica para um desconto, reembolso ou programa específico.
Handoff e escalonamento
Quando um Procedure termina em um handoff, é importante entender o que o desencadeou.
Como os handoffs são desencadeados
Existem duas formas de um Procedure fazer handoff para um humano:
Handoff configurado — Você adicionou um passo Handoff to team em um ponto específico do seu Procedure, ou escreveu orientações específicas do Procedure que instruem o Fin a fazer handoff em um cenário particular. Este é um resultado intencional que você projetou.
Comportamento padrão de escalonamento — Fin escala automaticamente com base em sua lógica interna: quando um cliente claramente pede para falar com um humano, quando Fin detecta forte frustração ou raiva, ou quando o cliente está preso em um loop repetitivo. Isso sempre ocorre independentemente de como seu Procedure está configurado.
Aplicando guidance do workspace dentro de um Procedure
Dê ao Fin orientações específicas sobre como interagir com os clientes enquanto executa um procedimento. Para adicionar guidance, abra um Fin Procedure e role até a seção Guidance, que aparece diretamente no editor acima das Instructions.
Guidance em nível de workspace não se aplica automaticamente dentro de um Procedure. Você deve selecioná-lo explicitamente usando o menu suspenso General Fin guidance:
Estilo de comunicação
Contexto e esclarecimento
Handover e escalonamento
Outras orientações
Guidance personalizado
Você também pode escrever guidance personalizado específico para o procedimento no campo Custom guidance — isso se aplica apenas a este procedimento. O Fin combinará isso com qualquer guidance em nível de workspace que você tenha selecionado. Por exemplo: "Nunca mencione um reembolso a menos que o cliente o mencione primeiro."
Nota: Tenha estas três coisas em mente ao usar guidance do workspace dentro de um procedimento:
Guidance é aditivo, não substitutivo. Quando o guidance do workspace está ativado, o Fin o combina com qualquer guidance específico do procedimento que você escreveu. Um não cancela o outro — ambos se aplicam juntos.
Regras amplas do workspace podem ser acionadas no meio do procedimento. Como o guidance do workspace é avaliado enquanto o Fin gera cada resposta, uma regra ampla pode compartilhar informações com o cliente mais cedo do que seu procedimento pretendia. Se uma regra deve se aplicar apenas fora do contexto do procedimento, restrinja seu escopo usando condições de público ou mova essa lógica para o procedimento como um passo explícito.
A escalada embutida do Fin sempre se aplica. O comportamento padrão de escalada do Fin — acionado quando um cliente pede um humano, expressa forte frustração ou raiva, ou fica preso em um loop repetitivo — sempre se aplica dentro de um procedimento independentemente das suas configurações de orientação. Isso é separado da Orientação de Escalada e Regras de Escalada em nível de workspace, que você deve ativar explicitamente no painel de Orientação.
Configurar mensagens finais
Por padrão, o Fin envia "Algo mais em que posso ajudar?" quando um procedimento termina. Você pode personalizar essa mensagem por etapa de término, definir um padrão global ou deixá-la vazia para não enviar nada.
Cada etapa de término tem uma mensagem configurável. Clique na pílula End para abrir um painel lateral onde você pode escrever uma mensagem personalizada usando texto rico e menções @attribute.
Para definir uma mensagem padrão para quando o procedimento for concluído naturalmente (sem atingir uma etapa End), abra o diálogo de Configurações do procedimento e vá para a aba Mensagem final.
Nota: As mensagens finais suportam localização automática — elas são traduzidas para os idiomas permitidos do workspace, respeitam as configurações do glossário e são exibidas no idioma da conversa do cliente.
Selecione seus Canais
Para executar um procedimento em canais específicos, como Web, iOS, Android, Facebook, WhatsApp, Instagram, SMS, Email ou Slack, use as configurações de Audience targeting dentro do editor de procedimento. Certifique-se de que o canal desejado esteja selecionado no menu suspenso Channels.
Para executar um procedimento para um público específico, use as configurações de Audience targeting dentro do editor de procedimento. Certifique-se de que o canal desejado esteja selecionado no menu suspenso Audiences.
Testar e verificar o procedimento
Antes de ativar seu procedimento, você deve verificar se ele funciona conforme o esperado. Clique no botão Test no topo do editor para acessar dois métodos de teste:
Visualizar
A aba Preview permite que você interaja com o Fin como um cliente faria. Use isso para sentir o tom, a saudação e o fluxo geral da conversa.
Simulações
A aba Simulations permite testar automaticamente diferentes caminhos lógicos dentro das suas instruções. Isso dá confiança de que o Fin se comportará conforme o esperado antes de lançar o procedimento para clientes reais.
Preview vs. Simulations — qual devo usar? Preview mostra a experiência completa para o cliente — usá-lo enquanto seu procedimento está ativo pode expor mensagens a clientes reais. Simulations executam o procedimento em segundo plano sem saída para o cliente, sendo a forma mais segura de validar a lógica antes de ativar.
Escolha um tipo de simulação:
Caminho feliz: A IA do Fin sugere automaticamente um cenário padrão para ajudar você a começar rapidamente e ver como o recurso funciona.
Você também pode criar Simulações Personalizadas: Crie cenários específicos para testar casos extremos ou integrações técnicas definindo:
O contexto: Defina a mensagem inicial do cliente e como a conversa deve prosseguir.
Dados simulados: Defina entradas personalizadas e respostas simuladas do Data Connector para simular como o Fin lida com dados ao vivo (por exemplo, uma resposta "Pagamento Falhou" do Stripe).
Critérios de sucesso: Especifique os resultados exatos que você espera, como quais ferramentas devem ser acionadas ou quais informações o Fin deve fornecer.
Executar e revisar:
Execute a simulação para ver o Fin executar suas etapas, acionar as APIs simuladas e seguir sua lógica.
Aprovado: A simulação atendeu a todos os critérios definidos.
Falha: A simulação falhou. Clique na simulação para ver exatamente onde o Fin se desviou das instruções.
Quando estiver satisfeito com os resultados, clique em Set live para tornar o procedimento disponível para seus clientes.
Saiba mais: Gerenciar versões e publicação de procedimentos, cobre o ciclo de vida da publicação, estados do procedimento, histórico de versões, reversão, notas de versão e pausa.
Alternar entre procedimentos de forma inteligente
Agentic Switch está disponível para procedimentos. Quando ativado, o Fin pode alternar automaticamente do procedimento atual para outro procedimento ativo se determinar que a intenção do cliente mudou e um procedimento diferente se adequa melhor à situação do cliente.
Adaptar-se automaticamente às necessidades do cliente em mudança:
O Fin analisa a conversa e as Descrições de Gatilho do Procedimento para determinar quando a troca de procedimentos serviria melhor ao cliente.
Fazer perguntas esclarecedoras quando necessário:
Se vários procedimentos puderem atender à situação do cliente, o Fin pode fazer perguntas esclarecedoras para desambiguar e selecionar a melhor opção.
Help Center tem prioridade:
O Fin continuará a priorizar o conteúdo do Help Center em vez do Agentic Switch ao responder às perguntas dos clientes.
Nota: Quando ativado em um procedimento, o Fin pode sair deste procedimento para qualquer outro procedimento ativo. O procedimento de destino não precisa ter o Agentic Switch ativado. Você ainda pode usar o comando @Switch para alternar procedimentos manualmente.















