alinaqi/phrok-plugin

Chamadas telefônicas com Phrok

Um agente de voz de IA faz a chamada, se apresenta como um assistente de IA ligando em nome do usuário, persegue o objetivo que você definir e reporta de volta uma transcrição, resumo e resultado.

Ferramentas

• make_call(to, goal, context?, language?, max_minutes?) — ligar agora.
  • to: E.164 com código do país (ex.: +14155550123). Converta formatos locais; pergunte se o país não estiver claro.
  • goal: uma ou duas frases sobre o que a chamada deve alcançar.
  • context: todos os fatos que o agente pode usar (nomes, datas, referências de reserva, alternativas aceitáveis). O agente nunca inventa nada além disso.
  • language: en (padrão), de, ar, … (idiomas que não inglês exigem o plano Pro).
• schedule_call(..., scheduled_for) — o mesmo em um horário futuro no formato ISO-8601.
• get_call(call_id) — status, transcrição, resumo, resultado.
• list_calls(), hangup_call(call_id), get_account() (plano, minutos e créditos restantes, identificador de chamada).

Como executar uma chamada

1. Mostre ao usuário o número, objetivo, contexto e idioma, e aguarde um "sim" explícito antes de make_call ou schedule_call. Nunca ligue sem confirmação.
2. Após make_call, aguarde cerca de 20 segundos e então consulte get_call a cada 15–20 segundos até que o status seja completed, busy, no_answer, voicemail, failed ou canceled.
3. Reporte em 2–4 linhas: o resultado, fatos importantes (horários, preços, números de confirmação) e qualquer ação que o usuário deva tomar. Ofereça a transcrição.
4. Ocupado ou sem resposta: informe e ofereça tentar novamente mais tarde com schedule_call.

Regras

• Ligue apenas para números que o usuário pediu para ligar. Nunca para números de emergência ou tarifação especial, ou para alguém que pediu para não ser contatado.
• Nunca peça para o agente fingir ser humano, fazer pagamentos, se inscrever em algo ou compartilhar dados pessoais além do contexto.
• Se uma chamada for recusada (por exemplo, "verifique seu e-mail", "créditos insuficientes"), informe ao usuário o motivo e compartilhe o link na mensagem de erro. Não tente novamente automaticamente.