Tutorial completo de construção de recepcionista de voz com IA usando…

INEMA

Aqui está a forma mais simples, direta e prática de configurar o VAPI para criar um agente de voz funcional — sem enrolação e seguindo exatamente o que funciona no vídeo.

✅ CONFIGURAÇÃO DO VAPI – PASSO A PASSO SIMPLES⌗

1. Crie um novo Voice Agent no VAPI⌗

No painel:

Agents → Create New Assistant → Voice Assistant

Escolha o modelo:

GPT-4.1 (ou o mais recente disponível)

Pronto — agora você tem a base do agente.

2. Defina a Mensagem Inicial⌗

No campo First Message, coloque algo como:

“Oi, eu sou a assistente virtual. Qual é o seu email para que eu possa te encontrar no sistema?”

Simples, direta e funcional.

3. Configure o System Prompt (Cérebro do Agente)⌗

Use apenas o essencial para começar:

```Você é uma assistente de voz amigável, rápida e sem pausas longas.

Antes de usar qualquer ferramenta, sempre diga frases como: “Só um instante…”, “Deixa eu verificar rapidinho…”

1) Peça o email logo no início. 2) Se o cliente for novo, peça nome e telefone. 3) Se já existir, pergunte o que deseja fazer: - Agendar - Reagendar - Cancelar - Perguntas gerais 4) Nunca fique em silêncio. Sempre fale algo enquanto processa.```

💡 Você pode expandir isso depois.

4. Conectar o VAPI ao n8n através do MCP Server⌗

A. No n8n⌗

Crie um workflow com o nó MCP Server Trigger.
Ative o workflow.
Pegue a URL Production.

B. No VAPI⌗

Vá em Tools → Add Tool → MCP Server
Coloque:

Server URL: cole a URL do MCP Server Trigger 3. Adicione um header:

Name: Authorization Value: Bearer SUA_API_KEY_DO_N8N

💡 Pegue essa chave em: n8n → Settings → API → Create Key

Altere o modo para:

Server-Sent Events (SSE)

Pronto — o VAPI agora pode se comunicar com o n8n.

5. Mapear as ferramentas (workflows)⌗

Depois que o MCP conectar, o VAPI vai mostrar:

Client Lookup
Create Client
Check Availability
Book Event
Update Event
Delete Event
etc.

👉 Basta ativar cada uma delas e dar nomes claros, como:

"crm_lookup"
"book_time"
"update_appointment"

6. Configurar o áudio (opcional, mas recomendado)⌗

Voice:⌗

Escolha a voz mais natural (ex.: “Emily”, “Grace”, “Liam”).

Interruptions (barge-in):⌗

Habilite para permitir o usuário falar sobre a IA.

Speaking Style:⌗

Use "Fast + Casual" para parecer humana.

7. Conectar um número de telefone (opcional)⌗

No menu:

Phone Numbers → Create Number

Escolha um número gratuito do VAPI.
Em Routing, selecione:

Inbound calls → Your AI assistant

Pronto: seu agente atende ligações reais.

8. Teste no próprio VAPI (antes de usar telefone)⌗

Use o botão Test Call.

Verifique se:

O agente pede o email.
Ele fala algo antes de chamar ferramentas.
Ele entende horários.
Ele responde rápido (sem silêncio).

🎯 CONFIGURAÇÃO MÍNIMA PARA FUNCIONAR⌗

Para deixar claro, aqui está o mínimo necessário:

✔ Criar assistente⌗

✔ Colocar mensagem inicial⌗

✔ Adicionar um system prompt simples⌗

✔ Conectar ao MCP do n8n⌗

✔ Mapear ferramentas⌗

✔ Testar⌗

É só isso. O agente já funciona.

🔥 HACKS DO VÍDEO – “AI Voice Receptionist with VAPI + n8n MCP”⌗

✅ 1. Use frases de preenchimento para eliminar silêncio (“latency masking”)⌗

Antes de qualquer chamada de ferramenta, a IA deve falar:

“Give me one sec…”
“Let me check that real quick…”
“Just a moment…”

👉 Hack: Isso esconde o delay do backend e deixa a IA natural como humana.

✅ 2. Separe cada função em um workflow independente⌗

Em vez de um workflow gigante, o criador usa 7 mini-workflows:

Consultar cliente
Criar cliente
Ver disponibilidade
Agendar
Localizar evento
Atualizar
Deletar

👉 Hack: Workflows simples → menos erros, menor latência, maior previsibilidade.

✅ 3. Nunca coloque IA no backend⌗

O autor reforça que:

“Se você coloca IA no backend + IA no VAPI, você dobra o custo, o tempo e os erros.”

👉 Hack: VAPI pensa. n8n só executa. Zero IA nos workflows para evitar decisões inconsistentes.

✅ 4. Use o MCP Server para evitar ter que configurar 7 ferramentas manualmente⌗

Em vez de criar ferramenta por ferramenta no VAPI, o MCP Server:

Expõe todos os workflows automaticamente
Descobre automaticamente quais parâmetros cada workflow aceita
Remove necessidade de manutenção dupla (VAPI + n8n)

👉 Hack: MCP Server = menos trabalho, menos configuração, muito mais flexível.

✅ 5. Construa todo o fluxo no papel antes de abrir VAPI ou n8n⌗

O autor repete várias vezes:

“Voice AI é não linear. Sem wireframe, você vai se perder.”

👉 Hack: Faça um mapa mental com caminhos como:

Novo cliente
Cliente existente
Agendar
Alterar
Cancelar
Transferir para humano
FAQ

O prompt fica muito mais fácil.

✅ 6. Adicione um PDF com políticas para evitar alucinações da IA⌗

Ele sobe um documento “Policies & FAQ” dentro do VAPI.

👉 Hack: Use a default query tool → IA responde apenas com dados reais do PDF. Nada de inventar respostas.

✅ 7. Forçar sempre a coleta de email primeiro⌗

Por quê?

Identifica cliente novo ou antigo
Mantém histórico
Permite personalização
Ajuda no CRM automático

👉 Hack: “What’s your email so I can look you up in the system?”

✅ 8. Atualizar agendamentos exige duas verificações⌗

A IA sempre deve:

Verificar disponibilidade do novo horário
Localizar o evento atual para obter o eventID

👉 Hack: Evita double-booking e erros de sincronização.

✅ 9. Use “structured outputs” no final da chamada⌗

No VAPI → End of Call Report:

summary: resumo automático
structuredData: outcome (status da chamada)

👉 Hack: Permite log automatizado no Google Sheets e dashboards.

✅ 10. Use o VAPI para transferir chamadas por “handoff”⌗

Dois tipos:

Para outro assistente interno (suporte, vendas, billing)
Para um número real humano

👉 Hack: IA só precisa reconhecer a intenção — o VAPI faz o resto.

✅ 11. Evite configurar parâmetros manualmente em ferramentas⌗

Se fizer via MCP:

Não precisa definir JSON schema manualmente
Não precisa criar ferramenta por ferramenta
N8n descobre tudo sozinho

👉 Hack: Automatiza quase toda a integração entre IA ↔ automações.

✅ 12. Teste e ajuste prompts dentro do editor do VAPI⌗

O editor permite:

Produto sugerir melhorias
Mostrar o que mudou (diff)
Experimentação rápida

👉 Hack: Economiza horas de tentativa e erro no prompt.

🔥 13. A maior sacada do vídeo: “Um cérebro só”⌗

A filosofia do criador:

“O agente de voz deve pensar. O backend só executa.”

É o oposto de como muita gente faz e o que causa:

Voz lenta
Falhas
Respostas confusas
Workflows complexos e difíceis de manter

👉 Hack definitivo: Todo o raciocínio fica no VAPI (IA). Toda a execução fica no n8n (sem IA).

youtube.com/watch ↗

Disponíveis na comunidade gratuita dele (School).

✅ Resumo em uma frase⌗

O vídeo ensina como construir uma recepcionista de voz totalmente automatizada usando VAPI + n8n, com lógica completa para CRM, agendamentos, transferência de chamadas, FAQs e logs, tudo configurado por meio de um MCP Server com 7 workflows personalizados.

✅ RESUMO DOS TÓPICOS DO VÍDEO – “I Built an AI Voice Receptionist with Vapi and n8n MCP”⌗

1. Visão Geral do Projeto⌗

Criado um agente de voz com IA que pode:
Atender chamadas
Identificar clientes
Criar contas
Agendar compromissos
Atualizar compromissos
Transferir ligações
Consultar FAQs
Registrar logs de chamadas
A automação é feita usando:
VAPI (frente: voz e decisão)
n8n com MCP Server (ferramentas do backend)
7 workflows personalizados no n8n
O criador disponibiliza:
system prompt
todos os workflows
guia PDF de 15 páginas

2. Demonstração ao vivo⌗

O vídeo mostra dois cenários:

Cenário 1 — Novo usuário⌗

Cliente liga pela primeira vez.
IA coleta: email, nome e telefone.
Cria automaticamente uma entrada no CRM.
Consulta disponibilidade no Google Calendar.
Agenda uma sessão de detalhamento interno para 8h.
Atualiza em tempo real o calendário, CRM e call log.

Cenário 2 — Cliente recorrente⌗

Cliente liga novamente.
IA identifica cliente pelo email.
Solicita mudança do horário do agendamento.
Verifica disponibilidade.
Busca o evento existente para obter o eventID.
Atualiza o agendamento para 9h.
Registra tudo no CRM e no call log.

3. Estrutura Geral do Sistema⌗

Frontend – VAPI⌗

Recebe e interpreta a fala.
Segue um extenso system prompt.
Chama ferramentas conforme necessário.
Mantém conversação natural usando frases de preenchimento ("give me a sec...").

Backend – n8n⌗

MCP Server recebe requisições de VAPI.
Sete workflows independentes realizam ações específicas:

Lookup de cliente
Criar cliente novo
Verificar disponibilidade
Agendar evento
Localizar evento
Atualizar evento
Excluir evento

Todos os dados são gravados em:
Google Sheets (CRM + logs + agendamentos)
Google Calendar

4. Wireframe e lógica condicional⌗

Autor explica que, antes de construir:

É essencial mapear todos os fluxos condicionais.
Conversações por voz são não lineares.
É necessário prever:
Cliente existente → coleta intenção
Cliente novo → coleta dados e cria conta
Intenção → perguntas gerais, agendar, alterar, cancelar, transferir
Cada ação requer ferramentas e dados diferentes

5. Integração VAPI ↔ n8n⌗

Para conectar:

Criar um MCP Tool no VAPI.
Inserir a URL do MCP Server Trigger.
Configurar cabeçalho:
Authorization: Bearer
Usar modo Server-Sent Events (SSE).
Associar cada workflow do n8n a uma "ferramenta" dentro do MCP.

6. System Prompt e Comportamento da IA⌗

A IA (Kylie):

Tem identidade e estilo definidos.
É amigável, rápida e nunca deixa silêncio.
Sempre fala algo antes de chamar ferramentas.
Regras claras para:
Saudar e pedir email
Criar novo cliente
Verificar disponibilidade
Agendar, alterar, cancelar
Transferir chamadas
Responder perguntas apenas com base no arquivo FAQ (subido ao VAPI)

7. Ferramenta de Handoff (Transferência de chamadas)⌗

Permite transferir a chamada:
Para um humano
Para outro assistente do VAPI (ex.: suporte)
Baseia-se nas regras do system prompt.

8. Knowledge Base / FAQs⌗

Um PDF com políticas e FAQs é enviado ao VAPI.
A IA responde perguntas usando default query tool.
Obrigação no prompt: “não inventar respostas”.

9. Logging das chamadas⌗

VAPI envia ao n8n:
Resumo da chamada
Resultado (ex.: agendamento criado, reagendado, cancelado)
O n8n grava tudo no Google Sheets.
Pode extrair dados estruturados (email, horário, serviço etc).

10. Conexão com número de telefone⌗

VAPI permite criar um número gratuito nos EUA.
O número é atribuído ao assistente de voz.
Pode ter fallback ou operações outbound.

11. Como obter os arquivos⌗

O criador oferece:
PDF com guia completo
Workflows n8n (JSON/ZIP)
System prompt *

eventID.

Ferramenta 6: Atualizar Agendamento⌗

Atualiza horário no Google Calendar.
Atualiza registro no Google Sheets.

Ferramenta 7: Excluir Agendamento⌗

Remove evento do Google Calendar.
Marca como “Cancelado” no Google Sheets.

Relatório de Fim de Chamada (EOC)⌗

Não é uma ferramenta MCP, mas um Webhook POST enviado pelo VAPI após cada ligação. Ele registra:

data
resumo da chamada
resultado

No Google Sheets, aba Call Log.

6. Guia de Configuração VAPI <-> n8n⌗

Explica como:

Ativar workflow do n8n
Configurar ferramenta MCP no VAPI
Inserir URL do MCP Server
Adicionar cabeçalho Authorization: Bearer
Ajustar modo SSE
Mapear as ferramentas para os workflows corretos

Se a configuração não estiver exata, o agente falará “estou verificando isso”, mas não receberá dados do n8n.

Construa Sua Própria Recepcionista de IA com VAPI e n8n⌗

1. Conceitos & Estratégia⌗

O Plano: Por que Wireframing & Lógica São Importantes⌗

Antes de escrever uma única linha de código ou criar um prompt, é fundamental entender que IA de voz é não linear. Diferente de um formulário comum onde o usuário vai do Passo A ao Passo B, uma conversa por voz pode ir para qualquer lugar. O cliente pode pedir um preço, depois mudar para agendar um horário, ou pedir para cancelar um agendamento que nem havia mencionado ainda.

A Regra do “Primeiro no Papel”⌗

Para construir um sistema robusto como “Kylie”, você deve primeiro mapear toda a lógica condicional em papel ou lousa. Visualize cenários “Se / Então”:

Se o usuário é novo → Então coletar nome/email → Então criar entrada no CRM.
Se o usuário é existente → Então cumprimentar pelo nome → Então perguntar intenção.
Se ele quer agendar → Então verificar disponibilidade → Então oferecer horários.

Esse mapeamento facilita enormemente a construção:

Prompting no VAPI: você sabe exatamente quais instruções o agente precisa para lidar com casos específicos.
Workflows no n8n: você sabe exatamente quais ferramentas criar (ex.: "uma ferramenta só para verificar disponibilidade e outra apenas para agendar").

Resumo do Sistema⌗

O sistema é uma Recepcionista de Voz Autônoma com IA para uma empresa de estética automotiva. Ele substitui um atendente humano e realiza três tarefas principais:

Identificação do Cliente: Reconhece instantaneamente se o cliente é novo ou recorrente.
Gerenciamento de Agenda: Verifica disponibilidade, agenda horários e atualiza agendamentos.
Gerenciamento de CRM: Registra todas as interações, dados de contato e resultados de chamadas.

2. Visão Geral do Sistema Técnico⌗

O projeto conecta VAPI (voz e tomada de decisão) com n8n (automação), criando “Kylie”, uma recepcionista virtual simpática para Hercules Detailing.

VAPI: controla voz, conversa e decisões.
n8n: funciona como “cérebro das ferramentas” via MCP Server, cuidando de CRM, agenda e logs.
Google Sheets: funciona como banco de dados CRM.
Google Calendar: gerencia horários.

3. Configuração VAPI (O “Cérebro”)⌗

A IA recebe instruções de comportamento e técnicas para eliminar silêncio durante chamadas.

Identidade e Estilo⌗

Nome: Kylie
Função: Recepcionista da Hercules Detailing
Tom: Casual, rápido, amigável e animado
Regra chave: Sempre dizer algo como “Só um instante” antes de usar ferramentas, evitando silêncio.

Prompt do Sistema⌗

(Todo o texto traduzido foi incluído no documento acima — mantive fiel ao original) Inclui:

saudação inicial
coleta de email
lógica de CRM
regras ao usar ferramentas (sempre falar algo antes)
fluxo para agendamento, atualização e cancelamento
manipulação de horários
regras para perguntas gerais
práticas de fallback e clareza

4. Arquitetura n8n (As “Ferramentas”)⌗

Usa-se um MCP Server Trigger no n8n, que encaminha cada requisição do VAPI para o workflow adequado.

Banco de Dados Necessário (Google Sheets)⌗

Clientes: Email, Nome, Telefone
Registro de Agendamentos: ID, Email, Tipo, Data, Notas
Registro de Chamadas: Data, Resumo, Resultado

5. Descrição dos Workflows⌗

Ferramenta 1: Consulta de Cliente⌗

Verifica se o email existe no CRM.
Se existir → retorna histórico.
Se não → informa que é novo.

Ferramenta 2: Criar Novo Cliente no CRM⌗

Adiciona uma nova linha no Google Sheets com email, nome e telefone.

Ferramenta 3: Verificar Disponibilidade⌗

Pesquisa eventos no Google Calendar no intervalo informado.
Sem eventos → dia totalmente disponível.
Com eventos → horários ocupados.

Ferramenta 4: Agendar Evento⌗

Cria evento no Google Calendar.
Registra no Google Sheets.

Ferramenta 5: Localizar Agendamento⌗

Retorna eventos para obter o

Recepcionista de Voz com IA usando Vapi e n8n MCP (modelo gratuito)

Uma recepcionista de voz totalmente baseada em IA usando VAPI no front-end e n8n no back-end, alimentada por um servidor MCP do n8n que se conecta a sete workflows do n8n.

Todo o sistema desde o início e mostro como o agente coleta informações, gerencia o CRM, agenda e atualiza compromissos, transfere chamadas, responde perguntas, registra cada ligação e mantém um histórico de agendamentos.

Tudo é construído sem código e projetado para ser fácil de personalizar para o seu próprio caso de uso. Ao final, você entenderá toda a configuração e terá tudo o que precisa para lançar sua própria recepcionista de IA.

o Zip tem todos os json

ap80 - Recepcionista VOZ - VAPI e MCP

chatgpt.com ↗