Guias

Chave na mão

Não quer construir o agente sozinho? Descreva a sua atividade e o que o agente deve fazer, e o fundador da volai constrói-o à mão por um preço fixo do catálogo - pronto em 24 horas úteis após o pagamento.

O que é o Chave na mão

O Chave na mão é um serviço pago pontual: inicie uma encomenda (no portal em /done-for-you, por REST com POST /v1/setup-orders ou com a ferramenta MCP create_setup_order), descreva numa só mensagem a sua atividade e o que o agente deve fazer, e receba de imediato um orçamento de preço fixo. O preço vem sempre de um catálogo no código (pacotes, extras, uma tarifa horária para trabalho adicional) - o modelo apenas escolhe itens a partir da conversa, nunca inventa nem ajusta um preço.

Após o pagamento, o fundador da volai constrói o agente à mão - não se trata de um modelo automático. Um número de telefone, o prompt de sistema, conhecimento retirado do seu sítio web e da sua tabela de preços, a transferência para um colega e dados estruturados das chamadas fazem parte de todos os pacotes.

Uma síntese mais curta para anúncios (sem os detalhes da API e do MCP) encontra-se na página Rececionista chave na mão.

Para quem é

O Chave na mão é adequado se não quiser configurar o agente sozinho no editor, ou se quiser um segundo número de telefone, vários agentes ou uma ligação a um calendário ou a um sistema de faturação e não quiser fazer essa integração à mão.

Como funciona a conversa

O modelo pode fazer, no máximo, cinco perguntas de esclarecimento antes de ter de produzir um orçamento - uma encomenda iniciada por REST ou MCP (create_setup_order) é, desde o início, de uma só mensagem: a primeira mensagem tem de conter tudo o que for relevante, o modelo nunca faz perguntas adicionais e tudo o que não estiver claro passa a ser um pressuposto no orçamento (selection.assumptions) em vez de uma pergunta. No portal, o modelo pode fazer perguntas adicionais até atingir esse limite.

Enquanto a encomenda aguarda pagamento (estado quoted ou awaiting_confirmation), outra mensagem SUBSTITUI o orçamento por um novo - a mesma regra de mensagem única aplica-se também a este. Assim que o cliente abre o checkout, o orçamento fica bloqueado durante 24 horas e rejeita qualquer nova mensagem com o erro checkout_open, para que nunca pague o preço antigo por um âmbito alterado.

Um item fora do catálogo (customItems) é cobrado em incrementos de meia hora à tarifa horária; quando os itens personalizados somam mais do que o limiar abaixo, o orçamento aguarda a confirmação do fundador (awaiting_confirmation) - o preço é provisório até ser confirmado.

Preços

O catálogo no código é a única fonte de preços - o orçamento, a fatura e esta página mostram os mesmos valores.

Pacotes (configuração pontual)

Extras

Trabalho fora do catálogo

Tudo o que esteja fora dos pacotes e dos extras (uma integração invulgar, uma alteração mais extensa) é cobrado em incrementos de meia hora à tarifa horária; acima do total deste limiar, o orçamento aguarda a confirmação do fundador antes de poder ser pago. (1,490.00 CZK / hora, limiar 4 horas)

O orçamento mostra também uma estimativa do custo mensal de funcionamento (número, minutos de chamada, agente) com a mesma calculadora de /pricing - não faz parte do preço da configuração e é debitado do saldo consoante a utilização real do agente.

As rondas de ajustes incluídas no pacote (Business 2, Company 3) contam a partir do estado `ready`, e não desde o início da construção. Uma ronda adicional custa 490.00 CZK e é debitada do saldo quando o fundador a conclui (`revision -> ready`) - não no momento do envio da mensagem.

O que se paga e quando

Um único pagamento cobre o preço da configuração E um primeiro carregamento de saldo (escolha um dos valores propostos) - o saldo paga depois o custo real de funcionamento do agente, como em qualquer conta. O checkout é aberto e pago por uma PESSOA; nada é cobrado automaticamente através de MCP ou REST - as ferramentas devolvem apenas uma ligação do Stripe Checkout.

Após o pagamento recebe um documento fiscal da taxa de configuração (e do carregamento de saldo), tal como num carregamento com cartão - em /credit ou através de list_billing_documents/get_billing_document.

Prazo e garantia

Pronto em 24 horas úteis após o pagamento - as horas que caiam num sábado ou domingo não contam para o prazo. O extra Express reduz-o para 4 horas.

Estados da encomenda

Uma encomenda percorre transições permitidas e fixas - tanto o cliente como o fundador só podem dar um conjunto limitado de passos (POST /v1/setup-orders/{id}/launch e .../cancel, ou os botões Lançar e Cancelar encomenda no portal).

O cancelamento por si só (cancel_setup_order/POST .../cancel) funciona apenas numa encomenda NÃO PAGA (draft, quoted, awaiting_confirmation ou declined) - uma encomenda paga só pode ser cancelada pelo fundador.

O que faz o próprio cliente

Alguns passos ficam sempre a cargo do cliente, porque mais ninguém os pode executar na sua conta junto do operador:

1. Reencaminhar um número existente para o número do novo agente junto do seu operador (recebe um guia com o agente concluído), ou simplesmente usar o novo número tal como está.
2. Ligar um Google Calendar ou um Calendário da Apple com um clique, caso tenha encomendado o extra de marcações no calendário.
3. Uma chamada de teste ao agente concluído antes de o lançar (launch_setup_order) - o lançamento é a confirmação do próprio cliente e nunca é feito automaticamente em seu nome.

REST e MCP

Sete endpoints em /v1/setup-orders (criar, listar, detalhe, mensagem, checkout, lançar, cancelar) e as mesmas sete ferramentas MCP (create_setup_order, list_setup_orders, get_setup_order, message_setup_order, checkout_setup_order, launch_setup_order, cancel_setup_order) chamam a mesma camada de serviço - as mesmas regras, os mesmos preços, os mesmos estados.

A referência completa com os erros de cada endpoint encontra-se na secção Setup orders da referência da API REST.

A descrição de cada ferramenta MCP está na área Chave na mão da página do servidor MCP.