Quem é você. Desenvolvedor de assistente de IA, agente de voz no veículo ou app de copiloto inteligente com acesso a ferramentas externas via tool-use. Problema. O motorista precisa sair do fluxo de direção para pagar pedágio; o assistente não tem contexto de passagens recentes para responder perguntas sobre custos de viagem. Solução Movvia. A API de Parceiros expõe endpoints que o assistente pode chamar como ferramentas — o motorista fala "paga o pedágio" e o agente executa o fluxo completo.
- Cadastre a placa do usuário na ativação do assistente via
POST /placas. - Exponha os endpoints Movvia como tools no seu agente (criar pedido, confirmar, consultar histórico).
- O evento
pe.transacao.recebidadispara uma proação do assistente: "Você passou pela Imigrantes. Confirmo o pagamento de R$ 12,50?" - O usuário responde por voz; o agente chama
POST /pedidos/{id}/confirmar. - O contexto de passagens alimenta respostas a perguntas como "quanto gastei em pedágio esse mês?".
Passo 1 — Cadastrar placa na ativação do assistente.
curl -X POST "$BASE_URL/placas" \
-H "Authorization: Basic $MV_KEY" \
-H "x-parceiro-id: $MV_PARCEIRO_ID" \
-H "Content-Type: application/json" \
-d '{"placa":"DEF5G67","metadata":{"usuario_id":"usr_ai_101","assistente":"CopilotoV2"}}'Passo 2 — Receber evento e disparar proação do agente.
{
"evento": "pe.transacao.recebida",
"dados": { "placa": "DEF5G67", "valor": 12.50, "praca": "KM 245 — Imigrantes" }
}Passo 3 — Usuário confirma por voz; agente chama a API.
curl -X POST "$BASE_URL/pedidos/ped_g7h8i9j0/confirmar" \
-H "Authorization: Basic $MV_KEY" \
-H "x-parceiro-id: $MV_PARCEIRO_ID" \
-H "Content-Type: application/json" \
-d '{"idempotencyKey":"conf_ped_g7h8i9j0"}'Revenue share customizado entre o desenvolvedor do assistente e a Movvia, baseado em volume de confirmações bem-sucedidas. Modelos de assinatura por usuário ativo também são avaliados caso a caso. Estrutura comercial sob consulta — comercial@movvia.com.br.