{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-parceiros/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Assistente IA veicular","description":"APIs públicas da Movvia para parceiros, estabelecimentos comerciais e clientes de dados veiculares.","meta":[{"name":"theme-color","content":"#7E3DEE"},{"name":"apple-mobile-web-app-title","content":"Movvia Docs"},{"name":"application-name","content":"Movvia Docs"}],"llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"assistente-ia-veicular","__idx":0},"children":["Assistente IA veicular"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["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."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"como-encaixa-no-seu-produto","__idx":1},"children":["Como encaixa no seu produto"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Cadastre a placa do usuário na ativação do assistente via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /placas"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Exponha os endpoints Movvia como tools no seu agente (criar pedido, confirmar, consultar histórico)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["O evento ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pe.transacao.recebida"]}," dispara uma proação do assistente: \"Você passou pela Imigrantes. Confirmo o pagamento de R$ 12,50?\""]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["O usuário responde por voz; o agente chama ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /pedidos/{id}/confirmar"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["O contexto de passagens alimenta respostas a perguntas como \"quanto gastei em pedágio esse mês?\"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"fluxo","__idx":2},"children":["Fluxo"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Passo 1 — Cadastrar placa na ativação do assistente."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"$BASE_URL/placas\" \\\n  -H \"Authorization: Basic $MV_KEY\" \\\n  -H \"x-parceiro-id: $MV_PARCEIRO_ID\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"placa\":\"DEF5G67\",\"metadata\":{\"usuario_id\":\"usr_ai_101\",\"assistente\":\"CopilotoV2\"}}'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Passo 2 — Receber evento e disparar proação do agente."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"evento\": \"pe.transacao.recebida\",\n  \"dados\": { \"placa\": \"DEF5G67\", \"valor\": 12.50, \"praca\": \"KM 245 — Imigrantes\" }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Passo 3 — Usuário confirma por voz; agente chama a API."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \"$BASE_URL/pedidos/ped_g7h8i9j0/confirmar\" \\\n  -H \"Authorization: Basic $MV_KEY\" \\\n  -H \"x-parceiro-id: $MV_PARCEIRO_ID\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"idempotencyKey\":\"conf_ped_g7h8i9j0\"}'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"modelo-de-receita-típico","__idx":3},"children":["Modelo de receita típico"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["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 — ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"mailto:comercial@movvia.com.br"},"children":["comercial@movvia.com.br"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"próximo-passo","__idx":4},"children":["Próximo passo"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/parceiros/tutorials/quickstart"},"children":["Quickstart Parceiros"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/parceiros/openapi"},"children":["Referência da API"]}]}]}]},"headings":[{"value":"Assistente IA veicular","id":"assistente-ia-veicular","depth":1},{"value":"Como encaixa no seu produto","id":"como-encaixa-no-seu-produto","depth":2},{"value":"Fluxo","id":"fluxo","depth":2},{"value":"Modelo de receita típico","id":"modelo-de-receita-típico","depth":2},{"value":"Próximo passo","id":"próximo-passo","depth":2}],"frontmatter":{"title":"Assistente IA veicular — Parceiros Movvia","description":"Como assistentes de IA e agentes de voz integram contexto de passagens de pedágio e confirmação de pagamento via tool-use.","seo":{"title":"Assistente IA veicular"}},"lastModified":"2026-04-24T22:40:19.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/parceiros/casos-de-uso/assistente-ia-veicular","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}