Ligue o seu software às suas operações de despacho.
Transforme encomendas em trabalhos de entrega, envie atualizações para o seu sistema e crie um assistente de IA que possa consultar o trabalho na RouteIQ Dispatch Software.
Duas formas de ligar
Crie a sua integração
O seu servidor comunica diretamente com a RouteIQ Dispatch Software. Crie trabalhos a partir de encomendas e receba atualizações através de webhooks.
Ver o fluxo REST → MCPLigue um assistente de IA
O conector local permite que um cliente MCP descubra operações da API e as execute com a sua chave de integração.
Ver o exemplo MCP →De uma encomenda a uma entrega atribuída.
Chega uma encomenda da sua loja ou sistema de reservas. A integração cria o trabalho na RouteIQ Dispatch Software e mantém a encomenda original atualizada.
Receba a encomenda
O seu sistema fornece o cliente, o serviço, a recolha e a entrega.
Crie o trabalho
Envie o trabalho para a RouteIQ Dispatch Software e guarde o ID devolvido.
Atribua um condutor
Escolha um condutor e um veículo elegíveis e envie a atribuição.
Sincronize o estado
Receba eventos através de um webhook e atualize o sistema de encomendas.
Pergunte por um trabalho. Receba uma resposta da RouteIQ Dispatch Software.
Comece com uma pergunta sobre um trabalho existente. O assistente usa o conector para o consultar e explica os dados recebidos.
Conversa ilustrativa · Dados de exemplo
Mostra a recolha, a entrega e o condutor atribuído a job-demo.
Recolha: 18 Market Street. Entrega: 42 Harbor Avenue. ID do condutor atribuído: driver-demo.
Este exemplo consulta um trabalho. Não cria nem atribui trabalhos.
O que acontece antes da resposta
- Descobrir
search_apiencontra a operação de consulta do trabalho. - Inspecionar e consultar
describe_apifornece o esquema;call_apienvia o ID do trabalho para a RouteIQ Dispatch Software. - Explicar o resultado
O assistente resume as paragens e o ID do condutor. Aplicam-se as permissões da sua chave API.
Ver a chamada de ferramenta e os dados de exemplo
{
"name": "call_api",
"arguments": {
"operation": "GET /job/{id}",
"path": {
"id": "job-demo"
}
}
}{
"id": "job-demo",
"driver_user_id": "driver-demo",
"stops": [
{
"order": 0,
"type": "pickup",
"address": {
"street_address": "18 Market Street"
}
},
{
"order": 1,
"type": "dropoff",
"address": {
"street_address": "42 Harbor Avenue"
}
}
]
}Configurar o conector local
Um cliente MCP com suporte para processos locais inicia o conector no seu computador ou servidor. Configure o URL do site e uma chave de integração dedicada através da gestão de segredos do cliente. Substitua o comando pelo caminho absoluto do executável instalado.
{
"mcpServers": {
"routeiq": {
"command": "/absolute/path/to/routeiq-mcp",
"env": {
"ROUTEIQ_API_URL": "https://YOUR-SITE.routeiq.app/api",
"ROUTEIQ_API_KEY": "YOUR-INTEGRATION-KEY"
}
}
}
}Para atribuir trabalhos, configure as confirmações necessárias no cliente. O conector executa as escritas imediatamente e não inclui um ecrã de aprovação.
Crie o fluxo de que precisa
Encomendas → despacho
Crie duas paragens, atribua um condutor e volte a consultar o trabalho.
Ver o exemplo (em inglês) →Assistente → detalhes do trabalho
Explore a configuração MCP e as ferramentas, ou ligue através de REST.
Ler o guia (em inglês) →Entrega → atualização da encomenda
Verifique as assinaturas dos webhooks e processe alterações de estado.
Ler o guia (em inglês) →Consulte a referência atual da API
Crie uma chave em Definições → Chaves API e escolha a função necessária para o seu fluxo. Guarde-a no servidor ou na gestão de segredos do cliente MCP. Consulte os esquemas e a autenticação atuais na referência do backend.