{"section":"tutorials","requestedLocale":"pt","requestedSlug":"agencias-vtex-tracking","locale":"pt","slug":"agencias-vtex-tracking","path":"docs/pt/tutorials/vtex-tracking/vtex-tracking---todos-os-artigos/agencias-vtex-tracking.md","branch":"main","content":"O cadastro de **Agências** em sua plataforma VTEX Tracking permite a personalização da comunicação por SMS e e-mail com seu cliente. Para contratantes do serviço VTEX Tracking que possuem mais de uma marca dentro de sua carteira de produtos, por exemplo, é importante que a comunicação com o cliente seja feita de forma personalizada. Para evitar que o cliente receba uma informação de entrega e não saiba a que marca se refere, é possível customizar a mensagem. \n\n## Por que devo configurar uma Agência?\n\nVamos supor que a loja ABC vende eletrodomésticos de marcas diferentes: a marca Azul e a Rosa. É a loja ABC que é a contratante VTEX Tracking, e não cada marca individualmente, portanto é a loja que gerencia todo o sistema de comunicação sobre entregas. Para o cliente final, Azul e Rosa vendem produtos diferentes e são empresas totalmente sem vínculo. Se o sistema comunicar a esse cliente que seu produto da empresa ABC está a caminho,  pode ser que ele desconheça e não identifique a que se refere essa entrega. Por isso é possível customizar a comunicação feita com seu cliente, para segmentar marcas diferentes à sua operação logística com o VTEX Tracking. \n\nPara atender a esse cenário, é preciso cadastrar Agências e definir a comunicação para cada uma. Seguindo o exemplo acima, criamos uma agência para marca Azul e outra agência para a marca Rosa com textos personalizados.\n\n Neste artigo você aprenderá a:\n\n- Consultar agências  \n- Criar nova agência  \n- Campos de cadastro de agência  \n- Como configurar e-mail e SMS  \n- Status   \n- Templates  \n- Tags  \n\n## Consultar agência\n\n1. Acesse o módulo **Configurações da Conta**.  \n2. Acesse a aba **Agências**.  \n3. Clique em **Consultar Agências**.  \n\nUma vez no painel, é possível: \n- Buscar agência pelo nome ou CNPJ, utilizando a barra de busca.  \n- Selecionar uma agência, e conferir detalhes de sua conta, clicando no botão `:`.  \n\n## Criar nova agência\n\n1. Acesse o módulo **Configurações da Conta**.  \n2. Acesse a aba **Agências**.  \n3. Clique em **Nova Agência**.  \n4. Preencha os campos de cadastro da agência.   \n5. Marque a caixa de seleção **Ativo** para ativar a agência.  \n5. Clique em **Criar**.  \n\n### Campos de cadastro de agência\n\n- **Nome:** nome referente à agência (ou marca) que será criada.   \n- **Logotipo:** selecione o arquivo, a partir das imagens salvas no seu computador, correspondente ao logotipo da marca.  \n- **Cor:** selecione a cor correspondente à marca, que será exibida no cabeçalho da tela do LastMile, acessada pelo destinatário. Clicando na barra de cor, e em seguida no ícone onde está escrito `RGB`  é possível inserir o código RGB, HEX ou HSL da cor.   \n- **E-mail:** configure os e-mails que serão enviados para o consumidor clicando no botão de edição.   \n- **SMS:** configure os SMS que serão enviados para o consumidor clicando no botão de edição.   \n- **Ativo:** marque a caixa de seleção para ativar a agência cadastrada.  \n\n### Como configurar e-mail e SMS \n\nPara cada status de entrega, é enviado um e-mail e um SMS para o consumidor com informações que podem ser customizadas. A tela **Configuração Email** e **Configuração SMS** é onde você irá inserir as informações personalizadas para cada comunicação que será enviada para seu destinatário. Para configurar SMS ou e-mail, siga o tutorial abaixo.\n\n 1. Em **Nova Agência**, clique no **botão de edição**.  \n 2. Na barra superior, selecione o *Status* que deseja configurar.    \n*Status incluem: Rota itinerante, Antes de Roteirizar, Rota Iniciada, Entrega Iniciada, Entrega Realizada, Entrega Não-Realizada, Entrega Sem Agendamento, Fora do Prazo.* \n 3. Marque a caixa de seleção **Ativo**.  \n 4. Selecione somente um dos *templates* disponíveis.     \n*O template escolhido nesta etapa será o que será disparado pelo sistema, para aquele status. O template *Personalizado* é o único que poderá ser alterado.*  \n 5. Se desejar, altere o **Assunto**.  \n 6. Edite o **corpo** da mensagem como desejar.  \n*O corpo do email deve ser preenchido em HTML, CSS e Javascript. Já a mensagem SMS pode ser preenchida em texto normal, substituindo os valores variáveis pelas `{{tags}}`, que explicaremos a seguir.*   \n 7. Clique em **Salvar**.  \n\n![PT Tracking Agencia Configurar email](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/vtex-tracking/vtex-tracking---todos-os-artigos/agencias-vtex-tracking_1.png)\n\n#### Status \n\nA imagem abaixo representa o fluxo de disparo de emails e SMS para destinatários presentes em uma rota. \n\n![PT Tracking Agencia status disparo](https://cdn.statically.io/gh/vtexdocs/help-center-content/refs/heads/main/docs/pt/tutorials/vtex-tracking/vtex-tracking---todos-os-artigos/agencias-vtex-tracking_2.png)\n\n- **Rota itinerante:** rota itinerante é aquela que demora mais de um dia para ser concluída. A comunicação é enviada quando o portador inicia a primeira entrega da rota. No email ou SMS a mensagem avisa que o serviço está em rota, e determina que a entrega será feita até o dia cadastrado como a data de fim da rota. \n- **Rota Iniciada:** enviado quando o portador inicia a primeira entrega da rota. Todos os pedidos dentro daquela rota recebem uma previsão estimada, que será atualizada quando a comunicação de Entrega Iniciada for enviado.    \n- **Entrega Iniciada:** enviado quando o portador dá início à entrega de um serviço específico. Quando chegou a vez de uma determinada entrega dentro de sua rota, é enviada a mensagem com a previsão de entrega.      \n- **Entrega Realizada:** enviado quando o portador confirma o status de uma entrega através do app móvel.    \n- **Entrega não Realizada:** enviado quando não foi possível realizar a entrega. Portador indica o motivo através do app móvel.    \n- **Entrega sem Agendamento:** enviado quando não há agendamento.     \n- **Fora do Prazo:** aviso de que a entrega não será enviada conforme o prazo.    \n\n#### Templates\n\n- **Personalizado:** configure seu template do zero.\n- **Padrão:** Corresponde ao horário de entrega do pacote. Já vem com um modelo previamente preenchido, que não pode ser alterado.   \n- **Período:** indica em qual período do dia o pacote será entregue. Já vem com um modelo previamente preenchido, que não pode ser alterado. \n- **Intervalo:** determina a previsão de faixa de horário que o pacote será entregue. Marque o horário desejado através da caixa ao lado da descrição. Já vem com um modelo previamente preenchido, que não pode ser alterado. \n- **Até:** previsão de horário limite de entrega. Marque o horário desejado através da caixa ao lado da descrição. Já vem com um modelo previamente preenchido, que não pode ser alterado. \n- **Saiu:** indica que o pedido saiu do centro de distribuição e está a caminho. Já vem com um modelo previamente preenchido, que não pode ser alterado. \n- **HEC:** indica o horário de entrega. Já vem com um modelo previamente preenchido, que não pode ser alterado. \n\n#### Tags\n\nAs `{{tags}}` entre chaves correspondem aos dados que são importados dos módulos de Serviço e Rota, para preencher os campos variáveis do e-mail e SMS. As tags seguem o formato HTML, portanto é necessário respeitar seus valores permitidos e formatação. As tags incluem:\n\n- **Logo:** link com a imagem da logo do contratante. Segue a tag `<img>` em HTML.\n- **ShipperName:** nome do contratante. \n- **ShipperCustomerFirstName:** primeiro nome do destinatário da entrega.\n- **InvoiceOrderOfService:** nota fiscal do serviço.\n- **OrderNumber:** número do pedido. \n- **DeliveryDay:** data da rota.\n- **Link:**  o link para visualizar a entrega através do LastMile.\n- **NonDeliveryReason:** ocorrências de entregas não realizadas.\n- **ItinerantDate:** data da rota itinerante, adicionada na planilha de importação de serviço. \n- **UpTo:** horário limite que a entrega será realizada. \n- **Interval:** descreve entre quais horários a entrega será realizada. É possível determinar um intervalo 1 em 1 hora, por exemplo.\nEx: Seu pedido será entregue entre 09:00hrs e 10:00hrs\n- **Period:** período do dia em que será realizada a entrega (manhã, tarde ou noite).\n- **HEC:** calcula a previsão exata para a entrega do pedido.\n- **OutForDelivery:** determina o momento exato em que a entrega foi iniciada."}