BotPhone

npx add-mcp 'https://auth.botphone.tel/mcp'

1. Como o agente funciona

Cada número do BotPhone possui um agente de IA com um prompt principal editável e uma base de conhecimento. A mesma identidade e instruções se aplicam quando o agente atende uma chamada recebida ou faz uma chamada de saída para você. Voz, modelo, divulgação, segurança, cobrança e regras de controle de chamadas são gerenciados pelo BotPhone para que a configuração continue simples.

O prompt principal responde a uma pergunta: O que este agente deve fazer? Você pode começar com um preset de Assistente Pessoal ou Recepcionista de Negócios, começar em branco, editar o prompt diretamente no painel do BotPhone ou dizer ao Muse qual tarefa você deseja que o agente execute.

Missões de chamadas de saída

Uma chamada de saída pode ter uma missão temporária além do prompt salvo. Por exemplo, um agente cuja função normal é gerenciar compromissos pode receber a missão "Ligue para meu dentista e remaneje o compromisso de sexta-feira". A missão se aplica apenas a essa chamada e não altera o prompt salvo do agente.

2. Conhecimento

Adicione informações que o agente possa usar em chamadas recebidas ou de saída. O conhecimento pertence a este agente e não substitui suas instruções principais.

• Texto colado: adicione políticas, serviços, preços, FAQs, horários ou qualquer outro material de referência aprovado.
• Uma página da web: forneça ao BotPhone uma URL pública para ler e indexar.
• Rastreamento de site: peça ao BotPhone ou ao Muse para rastrear um conjunto limitado de páginas públicas do mesmo site.

As fontes mostram seu status como na fila, buscando, indexando, pronto ou falhou. Apenas fontes prontas são usadas. Você pode atualizar, tentar novamente ou remover uma fonte a qualquer momento. Quando o agente não encontra uma resposta suportada, ele é instruído a dizer que não sabe em vez de inventar uma.

3. Edição pelo Muse

O Muse é a maneira mais fácil de configurar e gerenciar o agente. Você pode falar naturalmente em vez de preencher um longo formulário de configurações. Por exemplo:

• "Faça meu agente do BotPhone atender chamadas para meu negócio de encanamento e anotar uma mensagem clara quando não puder ajudar."
• "Aprenda os serviços e FAQs de example.com."
• "Adicione esta política de cancelamento ao conhecimento dele."
• "Deixe o prompt mais curto e diga aos chamadores que compromissos no mesmo dia não são garantidos."
• "Desfaça a última alteração no prompt."
• "Ligue para a Sarah e pergunte se terça às 14h funciona para ela."

O Muse resume as alterações de prompt e conhecimento antes de aplicá-las. As alterações de prompt são salvas no histórico, para que uma versão anterior possa ser restaurada sem excluir o histórico posterior. Uma solicitação de chamada é uma autorização para fazer essa chamada específica; a missão da chamada não altera o agente salvo.

4. Servidor e autenticação

• Servidor MCP: https://auth.botphone.tel/mcp (use a URL completa; não a encurte para o domínio)
• Autenticação: fluxo de código de autorização OAuth 2.0 com PKCE, sem segredo de cliente, registro dinâmico de cliente
• Endpoint de autorização: https://auth.botphone.tel/oauth/authorize
• Endpoint de token: https://auth.botphone.tel/oauth/token (método de autenticação: nenhum)
• Endpoint de registro: https://auth.botphone.tel/oauth/register
• Escopos: openid email profile

Configuração manual no Android

1. No Muse, abra Conectores e escolha Adicionar conector personalizado.
2. Para a URL do servidor, insira https://auth.botphone.tel/mcp, incluindo /mcp.
3. Quando o Muse solicitar um ID de Cliente, insira 59ca045f-f57c-4f33-bb63-dbcf97a6a0da.
4. Toque em Adicionar, faça login no BotPhone, revise as permissões e toque em Permitir.

Este ID de Cliente é público e não possui segredo. O PKCE (S256) protege o fluxo de login. O Muse no iPhone gerencia o registro do cliente automaticamente, então usuários de iPhone não precisam inseri-lo.

O prompt de conexão está disponível no botão Adicionar ao Muse na página BotPhone para Muse. A configuração de conta e linha telefônica está disponível em auth.botphone.tel/app/setup.

5. Ferramentas do conector

• get_agent_config (Leitura): O prompt atual do agente, status da linha, resumo do conhecimento e alteração mais recente.
• list_knowledge_sources (Leitura): Fontes de conhecimento e seu status de rastreamento ou indexação.
• get_prompt_history (Leitura): Versões recentes do prompt que podem ser revisadas ou restauradas.
• list_calls (Leitura): Chamadas recebidas e de saída recentes, das mais novas para as mais antigas, com chamador, horário, resumo, resultado, urgência e qualquer mensagem deixada.
• get_call_details (Leitura): Detalhes completos de uma chamada, incluindo a transcrição do texto.
• get_account_status (Leitura): Status da linha telefônica, saldo pré-pago, minutos restantes e conclusão da configuração.
• get_top_up_link (Leitura): Um link de pagamento do Stripe para adicionar crédito de chamada pré-pago.
• mark_calls_read (Escrita): Marca chamadas como lidas.
• update_agent_prompt (Escrita): Substitui o prompt principal do agente e salva a versão anterior no histórico. O Muse resume a alteração proposta e pede sua confirmação primeiro.
• add_knowledge_text (Escrita): Adiciona texto colado aprovado à base de conhecimento do agente.
• add_knowledge_website (Escrita): Lê uma página pública da web ou inicia um rastreamento limitado de um site público.
• refresh_knowledge_source (Escrita): Tenta novamente ou atualiza uma fonte de conhecimento de site.
• remove_knowledge_source (Escrita): Remove uma fonte e impede que o agente a use.
• restore_agent_prompt_revision (Escrita): Restaura um prompt anterior mantendo o histórico completo de alterações.
• place_call (Escrita): Faz o mesmo agente ligar para alguém em seu nome com uma missão temporária sobreposta ao prompt normal.

As ferramentas atuam apenas na conta do BotPhone da pessoa que aprovou a conexão. As operações de conhecimento e prompt são limitadas ao agente dessa conta.

6. Painel e testes

O painel do BotPhone fornece os mesmos controles principais para pessoas que preferem uma tela: escolher um preset inicial, editar o prompt principal, adicionar ou remover conhecimento, revisar o histórico do prompt e restaurar uma versão anterior. As alterações salvas se aplicam à próxima chamada.

Você pode testar o agente pelo painel sem alterar o prompt ou o conhecimento dele. Você também pode ligar para o número do BotPhone atribuído para testar a experiência real de chamada recebida.

7. Requisitos de acesso e preços

• Regiões: o BotPhone fornece números de telefone dos EUA. Chamadas de saída suportam destinos nos EUA e no Canadá.
• Permissão de saída: ligue apenas para pessoas que esperam a chamada. Você é responsável pelos requisitos aplicáveis de consentimento, identificação, telemarketing e não perturbe.
• Duração da chamada: uma única chamada tem limite de 10 minutos.
• Gravação: o áudio da chamada não é gravado. Transcrições de texto, resumos e mensagens são retidos por 12 meses.
• Canais: chamadas telefônicas hoje. O WhatsApp está chegando em breve e não é suportado atualmente.
• Conta: uma conta do BotPhone com login do Google ou e-mail, uma linha telefônica ativa e crédito de chamada pré-pago. Chamadas cobráveis param quando o saldo chega a $0.
• Preços: $2 de configuração, $2 por mês pelo número, $0,20 por minuto de chamada recebida e $0,10 por minuto de chamada de saída. O uso é cobrado por segundo. Consulte os Termos.

8. Limites de taxa

O BotPhone não publica atualmente limites fixos de taxa de solicitação para o conector durante o beta. O conector é destinado ao uso interativo por um indivíduo ou proprietário de pequena empresa através do Muse. Se você precisar de acesso de maior volume, entre em contato com info@botphone.tel.

9. Conformidade e suporte

Você é responsável pelas instruções e conhecimento que fornece, pelas pessoas que pede ao agente para ligar e por quaisquer requisitos de divulgação ou aviso que se apliquem ao seu uso. Não use o BotPhone para serviços de emergência ou decisões profissionais de alto risco. Consulte nossa Política de Privacidade e Termos. Suporte: info@botphone.tel.