Para levar seu assistente de Inteligência Artificial (IA) ao próximo nível, é preciso ir além da conversa e ensiná-lo a executar ações. Na Zárpon, isso é feito através de Funções. Elas são os "verbos" da sua IA, permitindo que ela interaja com os sistemas da plataforma para agendar consultas, gerenciar contatos, finalizar atendimentos e muito mais.
Este guia é um dossiê completo sobre cada função disponível, com exemplos práticos, a sintaxe correta para usar em seus prompts e as configurações necessárias no construtor de fluxos.
Parte 1: As Funções de Controle de Fluxo
Essas funções ditam o caminho que a conversa seguirá após a intervenção da IA, permitindo criar lógicas complexas e transferir o atendimento.
1.1. continueFunnel → Continuar o Fluxo
O que faz: É a função de continuidade mais simples. Ela encerra a atuação da IA e manda um sinal para o fluxo de automação seguir para o próximo bloco conectado.
Quando usar: Ideal para fluxos lineares e diretos. O caso de uso mais comum é quando um SDR de IA qualifica um lead e precisa transferi-lo para um atendente humano.
Instrução no Prompt: "Após qualificar o lead completamente, execute a função continue_funnel para transferir ao nosso time comercial."
Configuração na Zárpon: No bloco Assistente de IA, habilite a opção "Continuar o fluxo de atendimento". A conexão será feita pela única saída padrão do bloco.
1.2. conditionalStep → Direcionar o Fluxo com Parâmetros
O que faz: Uma função mais avançada que também continua o fluxo, mas enviando um parâmetro (uma palavra-chave) que permite criar múltiplas saídas lógicas.
Quando usar: Essencial para criar fluxos com bifurcações. Você pode ter um caminho para "agendamento_confirmado", outro para "duvida_tecnica" e um terceiro para "lead_desqualificado", cada um acionando ações diferentes.
Instrução no Prompt: "Se o cliente agendar a consulta, execute a função conditional_step com o parâmetro 'consulta_agendada'."
Configuração na Zárpon: No bloco Assistente de IA, ative a função "Continuar com base na resposta".
Crie uma nova opção para cada parâmetro que você definiu no prompt (ex: "consulta_agendada") e conecte cada saída a um bloco ou fluxo diferente.
Parte 2: As Funções de Gerenciamento de Dados do Lead
Essas funções permitem que a IA organize e personalize o atendimento em tempo real.
2.1. manageTag → Gerenciar Tags
O que faz: Adiciona ou remove tags do lead com base no contexto da conversa.
Quando usar: Para segmentar seus contatos dinamicamente.
Exemplos: adicionar a tag "interesse_botox" quando o cliente pergunta sobre o procedimento, ou remover a tag "lead_frio" e adicionar "lead_aquecido" após uma interação positiva.
Instrução no Prompt: "Quando o cliente demonstrar interesse em casamentos, execute a função manage_tags para adicionar a tag 'Lead Casamento'."
Configuração na Zárpon: No bloco Assistente de IA, ative "Gerenciar tags" e, na lista, selecione todas as tags que a IA terá permissão para manipular. Se uma tag não for selecionada aqui, a IA não conseguirá usá-la, mesmo que o comando esteja no prompt.
2.2. manageLeadVariables → Atualizar Variáveis
O que faz: Salva informações específicas da conversa em campos de dados do lead (as variáveis).
Quando usar: Para capturar dados essenciais (como a queixa principal de um paciente), personalizar a conversa (usando a variável do nome) ou passar contexto entre diferentes IAs.
Instrução no Prompt: "Quando o cliente informar seu nome, execute a função manageLeadVariables para salvar a resposta na variável 'lead_name'."
Configuração na Zárpon: No bloco Assistente de IA, ative "Manipular variáveis" e selecione as variáveis que a IA poderá preencher.
Parte 3: A Suíte de Funções de Agendamento
Este conjunto de funções permite que sua IA gerencie todo o ciclo de agendamentos. Para que funcionem, você precisa ter uma Agenda criada e configurada na Zárpon.
3.1. getDaysAvailable → Consultar Horários Disponíveis
O que faz: Consulta uma agenda específica e retorna os horários livres.
Instrução no Prompt: "Para agendar, primeiro execute a função getDaysAvailable para a agenda 'Dr. Igor' para os próximos 30 dias. Apresente ao cliente apenas 3 opções, em dias e períodos alternados."
3.2. schedule → Realizar o Agendamento
O que faz: Após o cliente escolher um horário, esta função efetivamente marca o compromisso na agenda.
Instrução no Prompt: "Após o cliente confirmar o dia e horário desejado, execute a função schedule para confirmar o agendamento."
3.3. getScheduledDatesForLead → Verificar Agendamentos Existentes
O que faz: Verifica se o lead atual já possui algum agendamento marcado.
Instrução no Prompt: "Se o cliente pedir para reagendar, primeiro execute a função getScheduledDatesForLead para verificar se ele possui uma consulta ativa."
3.4. cancelScheduledForLead → Cancelar Agendamentos
O que faz: Cancela um compromisso existente para aquele lead.
Instrução no Prompt: "Após confirmar que o cliente deseja cancelar, execute a função cancelScheduledForLead."
Configuração na Zárpon para a Suíte de Agendamento
No bloco Assistente de IA, ative o grupo de funções de "Agendamento" e, o mais importante, selecione a agenda correta que a IA deve consultar e manipular.
Parte 4: A Função de Finalização
4.1. finishWithReason → Encerrar a Conversa com um Motivo
O que faz: Finaliza o atendimento no chat e atribui um motivo de encerramento específico.
Quando usar: Para coletar métricas e alimentar o seu Dashboard. Essencial para entender por que os atendimentos são ganhos ou perdidos.
Instrução no Prompt: "Se o cliente informar que não tem interesse pois achou o preço alto, execute a função finishWithReason com o motivo 'Perdido - Preço'."
Configuração na Zárpon : O bloco Assistente de IA, ative "Finalizar conversa com motivo" e selecione os motivos que a IA poderá usar. Os motivos devem ser previamente cadastrados nas configurações gerais da Zárpon.
FAQ: Perguntas Frequentes sobre a Execução de Funções
Tire todas suas dúvidas sobre nossa solução de IA conversacional
1- Minha IA não está executando uma função que pedi no prompt. O que devo verificar?
Verifique três pontos:
1) Clareza do Prompt: A instrução é explícita e imperativa (ex: execute a função...)?
2) Ativação da Função: A função está habilitada dentro das configurações do bloco Assistente de IA?
3) Permissão do Item: O item específico (a tag, a variável ou a agenda) que a IA precisa manipular está selecionado na lista dentro da configuração da função?
2- Qual a real diferença entre continue_funnel e conditional_step?
Pense em saídas: continue_funnel possui uma única saída padrão para dar sequência ao fluxo de forma linear. conditional_step permite criar múltiplas saídas com nomes (parâmetros), possibilitando que você crie uma lógica de "bifurcação" para tratar cada resultado da conversa de forma diferente.
3- Como faço para a IA usar informações de uma conversa anterior em um novo fluxo (por exemplo, em uma Sequência de Follow-up)?
O contexto da conversa se perde ao iniciar um novo fluxo. A solução é: a IA 1 deve usar a função manageLeadVariables para salvar um resumo da conversa em uma variável. A IA 2, no fluxo de follow-up, deve ser instruída em seu prompt a iniciar a conversa tomando como base o conteúdo dessa variável.
4- A IA pode consultar um arquivo PDF para obter informações, em vez de eu colocar tudo no prompt?
Sim. Você deve anexar o arquivo PDF na criação do seu Assistente de IA. Depois, no prompt, dê uma instrução clara, como: "Para informações sobre o 'Combo Clássico', consulte o arquivo anexo tabela-de-combos.pdf e forneça os detalhes ao cliente".
5- É possível executar múltiplas funções em sequência (ex: adicionar uma tag e DEPOIS mudar a etapa do Kanban)?
Sim. A melhor forma de garantir a ordem é usar uma lista numerada nas instruções do seu prompt
(ex: "1. Execute a função manage_tags para adicionar a tag 'Agendado'.
2. Execute a função conditional_step com o parâmetro'mudar_etapa_kanban'.").
Isso cria uma "cadeia de pensamento" que a IA tende a seguir rigorosamente.