Guia para Configuração e Agendamento de Envio Automático de Relatórios PDF via WhatsApp Utilizando o Provedor Viasoft

Este documento serve como um guia passo a passo destinado a usuários do Orion que desejam automatizar o envio de relatórios PDF via WhatsApp utilizando o provedor Viasoft. A funcionalidade de agendamento permite que os relatórios sejam enviados automaticamente em intervalos predefinidos. Este tutorial cobre tudo, desde a configuração inicial do provedor de WhatsApp até o monitoramento detalhado dos envios.

Siga os passos abaixo:

Passo 1: Acesso página de Configurações

1. Na barra lateral esquerda, clique em 'Configurações' para expandir as opções disponíveis.

2. Dentro do menu de 'Configurações', localize e clique em 'Provedor de WhatsApp' conforme indicado na imagem.

Open

Passo 2: Criando um Novo Provedor de WhatsApp

1. Clique no botão 'Criar novo' no canto superior direito da tela, conforme indicado na imagem.

Open

Passo 3: Selecionando o Provedor de WhatsApp

1. Clique na caixa de seleção em 'Provedores' para exibir as opções disponíveis.

2. Selecione 'API-VsWhatsApp' da lista, como mostrado na imagem abaixo:

Passo 4: Configurando e Salvando o Provedor de WhatsApp

1. Nome: Dê um nome para o provedor, por exemplo, 'Provedor Vs WhatsApp'.

2. Phone Number ID: Insira o ID do número de telefone associado à conta do WhatsApp.

3. Token: Digite o token de acesso fornecido pela Meta.

4. Após preencher todos os campos necessários, clique no botão 'Salvar'.

Passo 5: Configurando o Template de Mensagem do WhatsApp

1. No menu principal, sob a seção 'Notificações', localize e clique em 'Template WhatsApp', como mostrado na imagem abaixo:

Passo 6: Criando um Novo Template de Mensagem para WhatsApp

1. Na tela de 'Templates de WhatsApp', clique no botão 'Criar novo', localizado no canto superior direito da tela, como indicado na imagem abaixo:

Passo 7: Selecionando o Provedor no Template de Mensagem

1. No formulário de novo template, localize a seção 'Provedores'.

2. Clique na caixa de seleção e escolha 'API-VsWhatsApp' como seu provedor, conforme demonstrado na imagem abaixo:

Passo 8: Configurando o Template

1. Nome: Digite um nome para o template no campo 'Nome'. Este nome ajudará a identificar o template no sistema, por exemplo, "Relatório de Vendas".

2. Template: No campo 'Template', insira o texto que será enviado como parte da mensagem. Você pode incluir variáveis ou texto fixo que será relevante para os destinatários.

3. Clique na aba 'Designer' localizada no topo do formulário. Esta aba permite que você redija a mensagem que será enviada.

Passo 9: Editando a Mensagem na Aba Designer

1. Clique na aba 'Designer' para acessar o editor de mensagens.

2. No campo de texto disponível, insira a mensagem que deseja enviar. Use chaves dupla para incluir variáveis (por exemplo, {{nome}}) que serão substituídas por dados específicos do destinatário ou do relatório quando a mensagem for enviada.

3. Exemplo de mensagem: "Olá {{nome}}, segue o relatório diário."

Passo 10: Configurando Parâmetros Opcionais

Se desejar usar variáveis no template, é possível definir e configurar parâmetros para isso na aba "Parâmetros".

1. Clique na aba 'Parâmetros' para visualizar e adicionar novos parâmetros que serão usados no template.

2. Clique no ícone de '+', e insira as informações necessárias para cada parâmetro, como 'Nome', 'Descrição', 'Campo' e o valor 'Padrão', se aplicável. Esses parâmetros corresponderão às variáveis inseridas na mensagem.

3. Nome: Este campo é usado para identificar o parâmetro dentro do sistema. Insira um nome que facilite a identificação de sua funcionalidade (exemplo: "nomeDestinatario").

4. Descrição: Forneça uma descrição que explique o uso do parâmetro (exemplo: "Nome do destinatário").

5. Campo: Especifique o campo de dados que será vinculado a esse parâmetro. Este é o campo que corresponderá ao identificador utilizado na mensagem, como {{nome}} na aba 'Designer'.

6. Padrão: Este campo é crucial e deve ser preenchido com o nome do campo de dados do sistema que será utilizado como fonte para o parâmetro. Isso garante que os valores corretos sejam puxados e inseridos no template de mensagem. Este campo não é opcional e deve ser configurado para cada parâmetro.

7. Após configurar um parâmetro, você pode especificar a fonte dos dados selecionando o campo apropriado em 'Campo Fonte de Dados', como 'nome', para garantir que o valor correto seja automaticamente inserido na mensagem.

8. Após configurar todos os parâmetros necessários, confirme e salve suas alterações clicando em 'Salvar' na parte inferior da tela.

Passo 11: Agendamento do Envio de Relatórios PDF via WhatsApp

1. Na interface principal do Orion, navegue até a seção de 'Relatórios PDF' onde todos os relatórios disponíveis são listados.

2. Localize o relatório que deseja agendar, como "Relatório de vendas". Clique no ícone do 'Lápis' (ícone de relógio) ao lado do relatório para acessar as opções de agendamento.

3. Acesse a aba 'Agendamento' do relatório que deseja configurar.

4. Marque a opção 'Habilita agendamento?' para ativar a configuração de agendamento.

5. Dentro da mesma aba, defina o horário em que o relatório deve ser enviado. Selecione 'Horário específico' e insira o horário desejado para o envio.

6. Clique na aba 'WhatsApp' dentro da configuração de Agendamento.

7. Selecione o 'Provedor do WhatsApp' que você configurou anteriormente para enviar o relatório.

8. Escolha o 'Template' de WhatsApp que deve ser usado para formatar a mensagem enviada com o relatório.

9. Se deseja enviar o relatório para números específicos, insira-os manualmente na seção 'WhatsApps'.

10. Caso prefira usar números dinâmicos provenientes de uma fonte de dados, marque a opção 'Utilizar números a partir de uma fonte de dados' e selecione a fonte desejada.

11. Após configurar todos os detalhes do agendamento, incluindo horário e destinatários via WhatsApp, clique em 'Salvar' para ativar o agendamento.

Passo 12: Monitoramento de Envios

1. A aba 'Envios' fornece um histórico detalhado de todas as tentativas de envio, mostrando datas, usuários que executaram o envio, status de sucesso ou falha, e detalhes adicionais sobre destinatários e a mensagem enviada.

2. Clique em 'Detalhes' ao lado de cada envio listado para visualizar informações específicas sobre os destinatários e a mensagem enviada.

Conclusão

Você concluiu com sucesso o processo de configuração do agendamento para o envio de relatórios PDF através do WhatsApp.

Para qualquer dúvida adicional ou suporte técnico, consulte o manual do usuário do sistema Orion ou entre em contato com o suporte técnico.