> ## Documentation Index
> Fetch the complete documentation index at: https://mayahub.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Prompt & Ferramentas

> Configure a base de conhecimento, ferramentas, variáveis e prompt do sistema da sua assistente para definir suas capacidades e comportamento. 

**Configure o objetivo da assistente e as ferramentas que ela pode usar durante as chamadas.**

**Base de Conhecimento**

Forneça informações para a assistente usar como base de conhecimento ao responder os clientes. Pode incluir conteúdos do site, documentos, etc.

**Seleção da Base de Conhecimento**

<AccordionGroup>
  <Accordion title="Escolher Base de Conhecimento" icon="book-open">
    **Selecione um repositório de base de conhecimento contendo informações relevantes para a assistente usar.**

    **Requisitos:**

    * Deve ser criado primeiro na sua seção de Bases de Conhecimento
    * Exibe status (Ativo, Processando, etc.) e descrição
    * Apenas suas próprias bases de conhecimento estão disponíveis

    <Tip>
      **Crie bases de conhecimento a partir de conteúdo de sites, PDFs ou documentos personalizados para fornecer à sua assistente informações específicas do domínio.**

      Para um guia completo de configuração, incluindo tipos de conteúdo, status de processamento, raspagem de sites e solução de problemas, consulte o **Guia Completo da Base de Conhecimento**.
    </Tip>
  </Accordion>

  <Accordion title="Modo Base de Conhecimento" icon="brain">
    **Escolha como a IA irá utilizar a base de conhecimento.**

    <CardGroup cols={2}>
      <Card title="Chamada de Função" icon="function">
        **Recomendado para a maioria dos casos:**

        Usa uma chamada de função para buscar informações na base de conhecimento somente quando necessário. Mais preciso e eficiente.
      </Card>

      <Card title="Injeção de Prompt" icon="syringe">
        **Para casos de uso simples:**

        Realiza uma busca após cada fala do cliente. Mais preciso, mas pode ser mais lento sem áudios de preenchimento.
      </Card>
    </CardGroup>

    <Note>
      **Disponibilidade do modo:** Os modos Speech-to-Speech e Dualplex suportam apenas o modo Chamada de Função.
    </Note>
  </Accordion>
</AccordionGroup>

## Ferramentas Personalizadas Durante a Chamada

Crie e atribua suas próprias ferramentas personalizadas que a IA pode usar durante a chamada com o cliente.

<CardGroup cols={2}>
  <Card title="Criar Ferramentas Personalizadas" icon="plus">
    **Crie ferramentas adaptadas às necessidades específicas do seu negócio:** integrações de API, consultas a banco de dados, fluxos de trabalho personalizados e chamadas a serviços externos.

    **Ação rápida:** Link direto para a página de criação de ferramentas.
  </Card>

  <Card title="Atribuir à Assistente" icon="link">
    Selecione quais ferramentas personalizadas esta assistente pode usar, com múltipla seleção, pesquisa por nome/descrição e atribuição em tempo real.

    **Escopo:** Apenas suas próprias ferramentas estão disponíveis.
  </Card>
</CardGroup>

<Tip>
  Consulte a documentação de **Ferramentas Personalizadas** para guias detalhados sobre criação e configuração de ferramentas personalizadas.
</Tip>

## Ferramentas Padrão

Escolha ferramentas integradas que a IA pode usar durante a chamada com o cliente.

<AccordionGroup>
  <Accordion title="Transferência Múltiplas de Chamadas" icon="phone-arrow-right">
    **Encaminhar chamadas para múltiplos números de destino**, como diferentes pessoas ou departamentos, de acordo com seu fluxo.

    **Casos de uso:**

    * Escalonamento para agentes humanos
    * Roteamento por departamento
    * Transferência para especialistas

    **Opções de configuração:**

    * **Modo padrão:** Use números de telefone comuns (ex.: +1234567890)
    * **Modo avançado:** Use formato SIP URI para provedores SIP (ex.: sip:+1234567890\@sip-server)

    **Para integrações SIP:**

    * Configure a transferência para o **modo Avançado**
    * Use o formato SIP URI: sip:numero\@sip-server
    * Verifique se seu provedor SIP suporta **SIP REFER**
    * Teste com diferentes formatos de URI se as transferências falharem

    <Note>
      **Instrução do Prompt:** Inclua no prompt do sistema algo como "chame a função de transferência quando o usuário solicitar falar com outra pessoa" para garantir que a IA utilize essa ferramenta de maneira adequada.
    </Note>

    <Tip>
      Se as transferências não estiverem funcionando, consulte nosso guia de solução de problemas de Integração SIP para soluções detalhadas.
    </Tip>
  </Accordion>

  <Accordion title="End Call" icon="phone-slash">
    **Encerra a chamada quando a conversa estiver completa.**

    **Casos de uso:**

    * Conclusão natural da conversa
    * Objetivo da chamada alcançado
    * Satisfação do cliente confirmada

    <Note>
      **Instrução de prompt:** Se a IA não encerrar a chamada automaticamente, inclua no seu prompt do sistema: **"call the hang\_up function to close the call"** quando a conversa deve terminar.
    </Note>
  </Accordion>

  <Accordion title="Entrada DTMF" icon="hashtag">
    **Envie entradas pelo teclado facilmente durante chamadas outbound**, permitindo navegação fluida por menus de IVR e fluxos de trabalho automatizados. A IA utiliza os botões do teclado ao ligar e responder aos prompts.

    **Casos de uso:**

    * Navegar em menus telefônicos
    * Digitar números de ramal
    * Inserir códigos de segurança
    * Navegação em sistemas IVR

    <Note>
      **Instrução de prompt:** Inclua no seu prompt do sistema instruções sobre quando usar entradas DTMF, como: **"use the send\_dtmf tool to navigate phone menus when needed to reach the right person."**
    </Note>

    Para informações detalhadas sobre as capacidades DTMF, consulte **Ferramentas e Funções**.
  </Accordion>

  <Accordion title="Agendamento de Compromissos" icon="calendar">
    **Integração de Agendamento em Tempo Real** com múltiplas plataformas de calendário.

    **Integrações disponíveis:**

    * [**Cal.com**](http://Cal.com)**:** Guia completo de configuração disponível em [Cal.com](http://Cal.com) Scheduling
    * **GoHighLevel:** Guia completo de integração em GoHighLevel Scheduling

    **Casos de uso:**

    * Agendar compromissos com calendários
    * Verificar disponibilidade em tempo real
    * Enviar detalhes de confirmação automática
    * Sincronizar com sistemas de calendário existentes

    <Note>
      Disponível quando a integração de calendário está habilitada nas configurações da sua plataforma.
    </Note>
  </Accordion>
</AccordionGroup>

## **Variáveis de Chamada**

Defina variáveis que podem ser passadas antes de realizar a chamada e usadas no prompt, como `<variable_name>`.

**Configuração de Variáveis**

<AccordionGroup>
  <Accordion title="Definição de Variável" icon="code">
    **Crie variáveis de chamada para fornecer informações à sua assistente antes do início da chamada.**

    **Processo de configuração:**

    * Defina nomes de variáveis e valores padrão
    * Passe os valores ao criar chamadas/leads ou ao importar clientes
    * Variáveis disponíveis imediatamente nos prompts e durante as chamadas
    * Use para personalização e contexto

    **Configuração:**

    * **Nome da variável:** Identificador (ex.: `customer_name`)
    * **Valor padrão:** Usado quando não é fornecido (ex.: `"John"`)
  </Accordion>

  <Accordion title="Uso de Variável" icon="code">
    **Como usar variáveis de chamada na sua assistente:**

    **Nos prompts do sistema:**

    * Referencie variáveis com a sintaxe `{variable_name}`
    * Personalize conversas dinamicamente
    * Forneça informações específicas de contexto

    **Exemplos:**

    * `{customer_name}` para personalização ("Olá customer\_name")
    * `{email}` para integrações de calendário
    * `{account_type}` para respostas personalizadas
    * `{company}` para contexto empresarial
  </Accordion>

  <Accordion title="Data Sources" icon="database">
    **Formas de popular variáveis de chamada:**

    **Entrada manual:**

    * Ao criar chamadas individuais
    * Através da criação de leads em campanhas

    **Métodos de importação:**

    * Importação via CSV com colunas de variáveis
    * Integração via API com dados de clientes
    * Sincronização direta com CRM

    **Integrações com plataformas de automação:**

    * **GoHighLevel (GHL):** Puxa automaticamente dados de contatos e campos personalizados
    * **Google Sheets:** Importa leads com variáveis a partir de colunas da planilha
    * Conecte-se a mais de 250 ferramentas e plataformas populares usando nossa plataforma no-code
    * Qualquer outra plataforma através de webhooks para integrações personalizadas

    **Integração de plataforma:**

    * População automática a partir de perfis de clientes
    * Conectado a bancos de dados de clientes existentes
    * Fluxos de trabalho de automação no-code
  </Accordion>
</AccordionGroup>

<Note>
  **As variáveis de chamada são essenciais para personalizar conversas com a IA.** Elas permitem que a IA use informações específicas do cliente durante as chamadas, tornando as interações mais relevantes e eficazes.
</Note>

## Configuração do Fluxo de Chamada

**Quem Fala Primeiro?**

Controle se sua assistente ou o cliente inicia a conversa.

<CardGroup cols={2}>
  <Card title="Assistente de IA" icon="robot">
    **Comportamento padrão: Assistente inicia a conversa**

    O assistente de IA cumprimentará imediatamente o cliente e iniciará o fluxo da conversa assim que a chamada for conectada.

    **Mais indicado para:** A maioria dos cenários de chamadas ativas, chamadas de vendas, lembretes de compromissos
  </Card>

  <Card title="Cliente" icon="user">
    **Aguardar o cliente: Assistente escuta primeiro**

    Se você escolher "Cliente", a IA aguardará o cliente falar primeiro antes de responder.

    **Mais indicado para:** Chamadas de suporte receptivas, cenários de recepção, assistência reativa
  </Card>
</CardGroup>

### Mensagem Inicial

**Configure a primeira fala do seu assistente**\
Defina o que seu assistente dirá assim que a chamada começar.

<AccordionGroup>
  <Accordion title="Mensagem Inicial em Texto" icon="message">
    Escreva a mensagem de abertura que seu assistente falará no início de cada chamada.

    **Melhores práticas:**

    * Mantenha-a concisa e amigável
    * Apresente sua empresa/propósito claramente
    * Defina as expectativas da conversa
    * Use variáveis para personalização (ex.: nome\_cliente)

    **Exemplo:** "Olá nome\_cliente, aqui é a Sarah da Empresa ABC. Estou ligando para acompanhar sua recente solicitação sobre nossos serviços. Você tem um momento para conversarmos?"
  </Accordion>

  <Accordion title="Mensagem Inicial em Áudio" icon="volume">
    **Opcional:** Faça upload de um arquivo de áudio personalizado em vez de usar texto para fala

    **Requisitos:**

    * Formato MP3 ou WAV
    * Gravação clara e de alta qualidade
    * Voz e tom profissionais
    * Compatível com a voz do assistente se estiver usando clonagem de voz

    **Benefícios:**

    * Pronúncia e entonação perfeitas
    * Voz da marca consistente
    * Primeira impressão profissional
    * Sem atraso do texto para fala na abertura

    <Tip>
      Isso funciona melhor se a voz da IA for clonada usando a mesma voz do áudio inicial.
    </Tip>
  </Accordion>
</AccordionGroup>

<Note>
  Consulte nosso guia de Mensagem Inicial para melhores práticas detalhadas e exemplos.
</Note>

## Prompt do Sistema

Defina a personalidade, os objetivos e as diretrizes de comportamento do assistente.

### Configuração de Prompt

<CardGroup cols={2}>
  <Card title="Prompt Personalizado" icon="pencil">
    Escreva seu próprio prompt do sistema do zero

    * Controle total sobre o comportamento do assistente
    * Personalizado para casos de uso específicos
    * Suporte a formatação em Markdown
  </Card>

  <Card title="Biblioteca de Templates" icon="folder">
    Comece com templates pré-construídos

    * Disponível em múltiplos idiomas
    * Diferentes tipos de conversas
    * Prompts testados e eficazes
  </Card>
</CardGroup>

### Boas Práticas

<AccordionGroup>
  <Accordion title="Seja Específco" icon="bullseye">
    Defina claramente o papel, os objetivos e as restrições do assistente.

    **Inclua:**

    * Quem o assistente representa
    * O que ele está tentando alcançar
    * O que ele deve/deve não fazer
  </Accordion>

  <Accordion title="Definir Limites" icon="shield">
    Defina quais tópicos e ações são proibidos.

    **Considere:**

    * Requisitos de privacidade de dados
    * Conformidade legal
    * Diretrizes da marca
  </Accordion>

  <Accordion title="Use Examplos" icon="lightbulb">
    Forneça conversas de exemplo para orientar o comportamento.

    **Os exemplos ajudam em:**

    * Tom e estilo
    * Comprimento das respostas
    * Como lidar com objeções
  </Accordion>
</AccordionGroup>