Para transformar seu assistente de Inteligência Artificial (IA) em um agente proativo e verdadeiramente autônomo, é essencial dominar o uso de Funções. Elas são os comandos que permitem à sua IA interagir com os sistemas da plataforma Zárpon para executar ações concretas, como agendar uma consulta, aplicar uma tag ou finalizar um atendimento.
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.
Função 1: continueFunnel → Continuar o Fluxo
O que faz: É a função de continuidade mais simples. Ela encerra a atuação da IA e manda o fluxo de automação seguir para o próximo bloco conectado de forma linear.
Quando usar: Ideal para fluxos diretos, como um SDR de IA que qualifica um lead e o transfere para um atendente humano sem a necessidade de lógicas complexas.
Exemplo Prático (SDR Básico)
Instrução no Prompt: "Após coletar o nome, e-mail e necessidade do lead, agradeça e 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".
Conecte a única saída padrão do bloco a um bloco de "Atendimento Manual".
Função 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). Isso permite criar múltiplas saídas lógicas no seu bloco de IA.
Quando usar: Essencial para criar fluxos com "bifurcações" lógicas. Por exemplo, criar um caminho para "agendamento_confirmado", outro para "duvida_tecnica" e um terceiro para o "fallback" (quando a IA não sabe responder).
Exemplo Prático (Fallback para Atendimento Humano):
Instrução no Prompt: "Se o cliente fizer uma pergunta cuja resposta não está na sua Base de Conhecimento, responda com naturalidade: 'Essa é uma ótima pergunta. Vou te encaminhar para um de nossos especialistas agora'. Em seguida, execute a função conditional_step com o parâmetro 'atendimento_humano'."
Configuração na Zárpon: No bloco Assistente de IA, ative "Continuar com base na resposta". Crie uma nova opção com o nome atendimento_humano e conecte sua saída a um bloco de "Atendimento Manual" com notificação."
Função 3: manageTag → Gerenciar Tags do Lead
O que faz: Adiciona ou remove tags do contato, permitindo uma segmentação dinâmica.
Quando usar: Para classificar leads com base em suas interações em tempo real.
Exemplo Prático (Clínica de Estética):
Instrução no Prompt: "Quando o cliente demonstrar interesse no procedimento de 'Botox', execute a função manage_tags para ADICIONAR a tag 'Interesse-Botox'. Se o mesmo cliente agendar uma consulta, execute a função manage_tags para REMOVER a tag 'Lead-Frio'."
Configuração na Zárpon: No bloco Assistente de IA, ative "Gerenciar tags". Na lista, selecione todas as tags que a IA terá permissão para manipular. Se uma tag não estiver selecionada aqui, a IA não conseguirá usá-la.
Função 4: manageLeadVariables → Atualizar Variáveis do Lead
O que faz: Captura informações da conversa e as salva em campos de dados do lead (variáveis).
Quando usar: Para coletar dados importantes (CPF, endereço, queixa principal) ou para passar contexto entre diferentes assistentes de IA.
Exemplo Prático (Paróquia - Intenção de Missa):
Instrução no Prompt: "Após o fiel informar o tipo de intenção, o nome e a data/horário da missa, execute a função manageLeadVariables para salvar uma síntese na variável 'dados_intencao', como neste exemplo: (Dados: Missa em Ação de Graças por João da Silva, domingo às 9h)."
Configuração na Zárpon: No bloco Assistente de IA, ative "Manipular variáveis" e selecione a variável dados_intencao na lista de permissões.
Funções 5, 6, 7 e 8: A Suíte Completa de Agendamentos Este conjunto de funções permite que sua IA gerencie todo o ciclo de agendamentos. Elas funcionam em conjunto e precisam que uma Agenda esteja criada e configurada na Zárpon.
• getDaysAvailable (Consultar horários) e schedule (Realizar agendamento)
Exemplo Prático (Barbearia):
Instrução no Prompt: "Para agendar um corte, siga estas etapas em ordem:
1. Execute a função getDaysAvailable para consultar a 'Agenda Barbearia' nos próximos 15 dias.
2. Apresente ao cliente apenas 3 opções de horário, em dias e períodos alternados.
3. Após o cliente confirmar o dia e horário desejado, execute a função schedule para confirmar o agendamento."
• getScheduledDatesForLead (Verificar agendamentos) e cancelScheduledForLead (Cancelar agendamento)
Exemplo Prático (Clínica - Cancelamento):
Instrução no Prompt: "Se o cliente pedir para cancelar uma consulta, siga estas etapas:
1. Primeiro, execute a função getScheduledDatesForLead para verificar se ele possui uma consulta ativa e confirme com ele qual deseja cancelar.
2. Após a confirmação, execute a função cancelScheduledForLead para remover o agendamento da agenda."
Configuração na Zárpon para a Suíte de Agendamento: No bloco Assistente de IA, ative o grupo de funções de "Agendamento". O passo mais importante é selecionar a agenda correta que a IA deve consultar e manipular.
Função 9: finishWithReason → Encerrar a Conversa com um Motivo
O que faz: Finaliza o atendimento no chat da Zárpon e atribui um motivo de encerramento específico, que alimentará seu dashboard.
Quando usar: Para coletar métricas e entender os resultados da sua operação. Essencial para medir taxas de conversão e motivos de perda.
Exemplo Prático (E-commerce):
Instrução no Prompt: "Se o cliente informar que não tem interesse pois o frete ficou caro, responda cordialmente e, em seguida, execute a função finishWithReason com o motivo 'Perdido - Frete Alto'."
Configuração na Zárpon: No bloco Assistente de IA, ative "Finalizar conversa com motivo". Os motivos de finalização devem ser previamente cadastrados nas configurações gerais da Zárpon para que possam ser selecionados aqui.