Tema
Configurar o addon Rotas
Tudo se configura em Configurações › Rotas (card Rotas, com o ícone de caminhão). A tela tem seis seções, nesta ordem: Operação, Regiões atendidas, Agenda, Motoristas, Roteirização automática e Mensagens automáticas.
Quem acessa
Só quem tem a permissão Planejar rotas e configurar. Veja permissões.
As alterações ficam num rascunho. Quando você muda qualquer campo, aparece a barra Alterações não salvas, com Salvar e Descartar. Só as seções que mudaram são gravadas.
Operação
| Campo | Para que serve |
|---|---|
| Nome do serviço | Como a IA e as telas chamam o pedido: "coleta", "visita técnica", "entrega". Aparece no assunto do chamado ("Coleta — Rua X, 10 · Bairro") e nos avisos. Padrão: coleta. |
| Endereço-base da empresa | Ponto de referência da operação. Ajuda a localizar corretamente endereços que existem em mais de uma cidade (ruas homônimas) em favor da sua região. Se o texto mudar, é localizado de novo ao salvar. |
| Tempo por parada (minutos) | Quanto o motorista leva em cada endereço. Entra no cálculo do horário previsto de chegada de cada parada. Padrão: 15. |
| Categoria dos chamados | A categoria de ticket usada nas coletas criadas por automação ou pela IA. Vazio = padrão do sistema. Uma automação pode escolher outra categoria no próprio nó. |
| Avisar a equipe a cada nova coleta | Ligado (padrão), a equipe recebe um aviso no sino (central de notificações, respeitando quem vê aquela conversa) a cada coleta criada, com região, data e endereço. A coleta em ROTA NÃO IDENTIFICADA chega com prioridade alta. |
Ao lado do endereço-base (e do ponto de partida dos motoristas) há o botão Localizar, que mostra o endereço encontrado e um link Conferir no mapa. Use para checar antes de salvar. Cada endereço novo localizado conta na cota mensal.
Regiões atendidas
Cada região é um agrupamento de endereços que o gestor enxerga como "uma rota" (por exemplo, ROTA BAIXADA e ROTA ZONA NORTE). A região aparece como um selo colorido nas coletas e nas paradas.
Para cada região você define:
- Nome e cor (uma de oito).
- Ativa: uma região desativada deixa de classificar endereços novos.
- Bairros (um por linha).
- Municípios (um por linha).
Duas formas de desenhar uma região
O Columba compara o bairro e o município do endereço localizado com as listas das regiões. Uma região pode ser desenhada de duas formas, e a diferença importa:
| Forma | Como preencher | Como funciona |
|---|---|---|
| Por bairros | Liste os bairros. Os municípios são opcionais. | O endereço cai na região se o bairro estiver na lista. Se você também listar municípios, eles servem só para delimitar: o bairro só vale dentro desses municípios. |
| Por município inteiro | Liste só os municípios, deixando os bairros vazios. | Qualquer endereço daquele município cai na região. |
Exemplos:
| Região | Bairros | Municípios | Resultado |
|---|---|---|---|
| ROTA BAIXADA | (vazio) | Nova Iguaçu, Belford Roxo, Duque de Caxias | Qualquer endereço desses três municípios. |
| ROTA ZONA NORTE | Tijuca, Grajaú, Vila Isabel | Rio de Janeiro | Só esses três bairros do Rio. Um bairro do Rio que não está na lista não cai aqui. |
| ROTA NITERÓI | Centro, Icaraí | Niterói | O "Centro" de Niterói. O "Centro" do Rio de Janeiro não cai aqui, porque o município não confere. |
Quando um endereço casa com duas regiões, o bairro vence o município.
Quando nenhuma região casa
Se o bairro e o município do endereço não estão em nenhuma lista, a coleta recebe ROTA NÃO IDENTIFICADA. O Columba nunca chuta a região: quem decide é você, na tela Rotas, escolhendo a região na mão. Com o tempo, adicione os bairros que aparecerem sem região.
Como o sistema lê o bairro
A comparação usa o bairro e o município como o mapa os devolve, não como o cliente escreveu. Ela ignora acentos, maiúsculas e pontuação ("Sao Goncalo" = "São Gonçalo"), mas não adivinha apelidos. Se uma coleta chegou como "ROTA NÃO IDENTIFICADA" e você sabe a região, abra a coleta, veja o endereço localizado e cadastre o bairro escrito do mesmo jeito.
Limites: até 50 regiões; até 500 bairros e 200 municípios por região.
Agenda
A agenda define quando a empresa atende. As datas oferecidas ao cliente são calculadas pelo sistema, no fuso horário do Brasil, com estas regras. A IA nunca calcula datas: ela só oferece as que o sistema devolve.
| Campo | O que faz | Padrão |
|---|---|---|
| Dias de atendimento | Dias da semana com coleta. Só esses dias são oferecidos. | Segunda a sábado |
| Horário de corte (hora cheia, 0 a 23) | Pedido confirmado a partir dessa hora não entra mais na rota do dia seguinte (ela já está sendo montada): a primeira data oferecida passa para um dia depois. | 20 |
| Antecedência mínima (dias) | Quantos dias à frente a primeira data oferecida precisa estar. 1 = a partir de amanhã. 0 = permite o próprio dia, antes do corte. | 1 |
| Horizonte máximo (dias) | Até quantos dias no futuro dá para agendar. | 14 |
| Máximo de coletas por dia | Teto somado de todas as regiões e motoristas. Quando o dia atinge o teto, ele deixa de ser oferecido. 0 = sem limite. | 0 |
| Datas bloqueadas | Feriados e dias sem atendimento. Nunca são oferecidos. | Nenhuma |
Exemplo, com a configuração padrão e domingo fechado: um pedido confirmado no sábado às 21h já passou do corte das 20h, então o "primeiro dia" seria domingo. Como domingo não é dia de atendimento, as datas oferecidas serão segunda, terça e quarta.
O teto por dia conta as coletas agendadas para a data (as canceladas e as não realizadas não entram na conta).
Na base da seção, o painel Próximas datas que a IA pode oferecer mostra o resultado das regras já salvas. Salve as alterações para ver o painel atualizado.
As regras valem para o que a IA e as automações oferecem
Quando o gestor edita a data de uma coleta na tela de Rotas, ele pode escolher qualquer data: o sistema não aplica o corte nem o teto nesse caso, porque a decisão é humana.
Limites aceitos ao salvar: antecedência de 0 a 30 dias, horizonte de 1 a 60 dias, teto de até 1.000 coletas por dia e até 100 datas bloqueadas.
Motoristas
Motorista é um usuário da sua conta com um ponto de partida e um horário de saída. Ainda não criou o usuário? Use o link Convidar usuário (veja Gestão de equipe). Dê a ele uma função com a permissão Ver as próprias rotas e dar baixa (o Operador já tem).
Para adicionar, escolha o usuário em Escolha um usuário da conta… e clique em Adicionar motorista. Para cada motorista:
| Campo | Para que serve |
|---|---|
| Ativo | Motorista inativo não entra na montagem das rotas. |
| WhatsApp (só números, com DDD) | O número tem dois usos: entregar o itinerário quando a rota é publicada e identificar o motorista quando ele escreve para o número da empresa (é assim que o fluxo de baixa pelo WhatsApp sabe quem está falando). Sem DDI, o Columba assume Brasil (55). Se ficar vazio, o Columba tenta usar o telefone do cadastro do usuário. Sem número, o aviso vai só pelo sino. |
| Horário de saída | A hora em que o motorista sai. É a base dos horários previstos de chegada. Padrão: 08:00. |
| Ponto de partida | Casa do motorista ou depósito. Use Localizar e confira. O selo Partida localizada indica que está pronto. Sem ponto de partida localizado, o motorista não entra na montagem das rotas. |
| Máximo de paradas por dia | Teto de coletas daquele motorista na divisão. 0 = sem limite. |
| Volta ao ponto de partida | Ligado (padrão), o trajeto de retorno entra no tempo e na distância da rota, e o Google Maps é aberto com o destino final na base. |
O aviso por WhatsApp
O itinerário é enviado pelo primeiro número de WhatsApp conectado da conta. Se o motorista não receber, confira o número (inclua o 55 se necessário) e se a conta tem um número conectado. O aviso no sino acontece em qualquer caso. Veja Mensagens automáticas.
Limite: até 50 motoristas.
Roteirização automática
Em vez de clicar em Montar rotas do dia todo fim de tarde, você pode deixar o Columba montar as rotas sozinho. Fica desligada por padrão.
| Campo | O que faz | Padrão |
|---|---|---|
| Montar as rotas automaticamente | Liga a montagem automática. | Desligado |
| Horário da montagem | A hora em que as rotas são montadas, no fuso do Brasil. Normalmente é o mesmo horário de corte da agenda. | 20:00 |
| Publicar e enviar aos motoristas sem revisão | Ligado, as rotas já saem publicadas: o motorista recebe o aviso no sino e o itinerário por WhatsApp, sem ninguém conferir. Desligado, ficam em rascunho para você revisar na tela Rotas. | Desligado |
| Avisar no sino quando montar | Quem gerencia as rotas recebe uma notificação com o resumo: quantas rotas, quantas coletas, quantas ficaram sem motorista ou sem localização, e se foram publicadas ou estão em rascunho. O aviso tem prioridade alta quando sobrou alguma coleta de fora. | Ligado |
Abaixo dos campos, a tela mostra Última execução (dia e hora) quando o Columba já montou as rotas.
Como funciona:
- Quando o horário chega, o Columba escolhe o próximo dia de coleta: amanhã (ou a antecedência mínima da agenda, se for maior), pulando os dias em que a empresa não atende e as datas bloqueadas.
- Monta as rotas com todos os motoristas ativos que têm ponto de partida localizado, do mesmo jeito que a montagem manual: divide as coletas por proximidade e ordena as paradas. Rascunhos que já existiam nesse dia são refeitos; rotas publicadas nunca são alteradas.
- Roda uma vez por dia no horário escolhido. A verificação acontece a cada 5 minutos, então a montagem pode começar até alguns minutos depois da hora marcada.
- Sem motorista ativo com ponto de partida localizado, nada é montado.
Publicar sem revisão
Com a publicação automática ligada, os motoristas recebem a rota sem que ninguém a confira. Coletas sem localização ficam de fora das rotas, e o resumo do sino é o único lugar que avisa. Mantenha Avisar no sino quando montar ligado e confira o resumo.
Mensagens automáticas
O Columba pode mandar mensagens de WhatsApp sozinho ao longo da rota: o itinerário ao motorista, uma cópia ao gestor e um aviso "a caminho" aos clientes.
| Campo | O que faz | Padrão |
|---|---|---|
| Ao publicar, enviar o itinerário ao WhatsApp do motorista | Quando a rota é publicada (por você ou pela roteirização automática), o motorista recebe a lista de paradas com horários e links de navegação. O botão Enviar itinerário da tela Rotas também só envia ao motorista se esta opção estiver ligada. | Ligado |
| WhatsApp do gestor | Recebe uma cópia do mesmo itinerário. Vazio = não envia. Só números, com DDI (sem DDI, o Columba assume Brasil). | Vazio |
| Avisar o cliente da próxima parada quando o motorista sair ou concluir a anterior | Liga o aviso automático "o motorista está a caminho" ao cliente. | Desligado |
| Mensagem ao cliente | O texto do aviso. Entre 10 e 600 caracteres. A tela mostra uma Prévia com nomes de exemplo. | Modelo abaixo |
Quando o cliente é avisado
O aviso vai para o cliente da próxima parada pendente, uma vez só por parada:
- quando o motorista sai para a rota (botão Saindo para a rota em Minhas rotas ou saindo pelo WhatsApp): avisa o cliente da primeira parada;
- quando o motorista dá baixa em uma parada, como Concluída ou Não realizada: avisa o cliente da parada seguinte.
O cliente precisa ter telefone na parada. O aviso fica registrado na conversa do cliente no Inbox e como comentário público na timeline do chamado. Na tela Rotas, a parada mostra cliente avisado HH:MM.
Modelo da mensagem ao cliente
O modelo aceita três variáveis, que o Columba troca pelos dados da parada:
| Variável | Vira |
|---|---|
nome | O primeiro nome do cliente. |
motorista | O primeiro nome do motorista. |
horario | A previsão de chegada (por exemplo, 09:05). Sem previsão, o Columba usa "daqui a N min" (pelo tempo de deslocamento) ou "em breve". |
Escreva cada variável entre chaves duplas. O modelo padrão é:
text
Oi {{nome}}! 🚚 O motorista {{motorista}} está a caminho para a coleta e deve chegar por volta de {{horario}}. Qualquer coisa é só responder aqui.O que o envio precisa para funcionar
- Um número de WhatsApp conectado na conta. As mensagens saem pelo primeiro número conectado.
- Telefone do motorista cadastrado em Motoristas (para o itinerário) e telefone do cliente na parada (para o aviso).
- Cota de mensagens do plano: cada mensagem enviada conta na cota mensal de mensagens, como qualquer outra. Com a cota esgotada, o envio não acontece.
Se a mensagem não chegar
O envio é feito na melhor tentativa: se falhar, a rota e a baixa continuam funcionando, sem erro na tela. Ao reenviar pelo botão Enviar itinerário, a tela avisa quando o itinerário não saiu (confira o WhatsApp do motorista e se há um conector conectado). Na API oficial do WhatsApp, texto livre fora da janela de 24 horas pode ser recusado pela Meta.
Leia também
- Visão geral do Rotas
- Coletas e rotas — montar e publicar
- Rotas nas automações