Plataforma - SMS

De uTech Tecnologia
(Diferença entre revisões)
Ir para: navegação, pesquisa
(→‎Dashboard)
(→‎Menu Campanhas)
 
(42 edições intermediárias de 2 usuários não apresentadas)
Linha 25: Linha 25:
 
== Menu ==
 
== Menu ==
  
−
{| class="wikitable" width="85%"
+
[[File:menu.png|right|150px]]
−
! scope="row" colspan=2 style="width: 15%" align="center"| Parâmetros para envio de SMS
+
<BR>
 +
Abaixo a lista de opções do menu da plataforma SMS.
 +
<BR>
 +
<BR>
 +
 
 +
 
 +
{| class="wikitable" width="65%"
 +
! scope="row" colspan=2 align="center"| Opções do Menu
 
|-
 
|-
−
! scope="row" style="width: 20%" align="right"| '''sourceaddr'''
+
! scope="row" style="width: 35%" align="right"| Inicio:
−
| Parâmetro utilizado para identificar quem está enviando a mensagem SMS. Ex. '''sms_server'''.<br />'''NOTA:''' Esse campo será utilizado nas respostas de confirmação do Gateway.
+
| Link para o ''dashboard''' do sistema
 
|-
 
|-
−
! scope="row" style="width: 20%" align="right"| '''destaddr'''
+
! scope="row" style="width: 35%" align="right"| Contatos:
−
| Parâmetro utilizado para inserir o numero destino da mensagem. Ex: '''48XXXXYYYY'''.
+
| Menu de gerenciamento e '''importação''' de contatos
 
|-
 
|-
−
! scope="row" style="width: 20%" align="right"| '''message_id'''
+
! scope="row" style="width: 35%" align="right"| Grupos:
−
| Parâmetro utilizado para inserir um identificador da mensagem, que será utilizado para mapear as respostas do gateway, informado se a mensagem foi enviada e recebida pelo destino.
+
| Menu de configuração, criação e remoção dos grupos de contatos
 
|-
 
|-
−
! scope="row" style="width: 20%" align="right"| '''message'''
+
! scope="row" style="width: 35%" align="right"| Blacklist:
−
| Parâmetro utilizado para inserir a mensagem a ser enviada.<br />'''NOTA:''' o campo deve ter os caracteres especiais ''escapados'', conforme '''[https://www.ietf.org/rfc/rfc1738.txt RFC 2396]''' - ''Uniform Resource Identifiers (URI): Generic Syntax''. A mensagem deve conter apenas caracteres da Table imprimíveis ASCII.
+
| Menu configuração dos números inseridos na '''Blacklist''.
 
|-
 
|-
−
! scope="row" style="width: 20%" align="right"| '''interface'''
+
! scope="row" style="width: 35%" align="right"| Mensagens:
−
| Seleciona por qual interface GSM (0 ou 1) a mensagem será enviada.<br />Parâmetro Opcional - Caso não seja selecionado, o Gateway fará a distribuição automática de acordo com a configuração do equipamento.
+
| Menu de mensagens '''Recebidas'''.
 
|-
 
|-
−
! scope="row" style="width: 20%" align="right"| '''sim_card'''
+
! scope="row" style="width: 35%" align="right"| Campanhas:
−
| Seleciona por qual C - SIM Card (0 ou 1) a mensagem será enviada.<br />Parâmetro Opcional - Caso não seja selecionado, o Gateway fará a distribuição automática de acordo com a configuração do equipamento.
+
| Menu de acesso e configuração as campanhas.
 
|-
 
|-
−
! scope="row" colspan=2 style="width: 15%" align="center"| Parâmetros recebidos pela aplicação - Status de envio e recebimento
+
! scope="row" style="width: 35%" align="right"| Recarga:
 +
| Menu para solicitar nova recarga de mensagens.
 
|-
 
|-
−
! scope="row" style="width: 20%" align="right"| '''sourceaddr'''
+
! scope="row" style="width: 35%" align="right"| Relatório:
−
| Parâmetro utilizado para identificar quem está enviando a mensagem SMS. Ex. '''sms_server'''.<br />'''NOTA:''' Esse campo terá o mesmo valor que foi incluído na requisição de envio.
+
| Menu de relatórios de envio e recebimento de mensagens.
 
|-
 
|-
−
! scope="row" style="width: 20%" align="right"| '''destaddr'''
+
! scope="row" style="width: 35%" align="right"| Estatísticas:
−
| Numero destino, utilizado no envio da mensagem. Ex: '''48XXXXYYYY'''.
+
| Acesso as estatísticas de envio e recebimento de mensagens , por Canal GSM /SIM Card (Quando utilizado Gateway uTech).
 
|-
 
|-
−
! scope="row" style="width: 20%" align="right"| '''message_id'''
+
! scope="row" style="width: 35%" align="right"| Configuração:
−
| Parâmetro utilizado no envio da mensagem utilizado para mapear as respostas do gateway.
+
| Menu de configuração do servidor de e-mail e mapeamento de erros.
 +
|}
 +
 
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
<br>
 +
 
 +
= Formato dos Arquivos CSV =
 +
 
 +
Os arquivos para importação dos contatos, deverão ser no formato texto (CSV) e com campos separados por '''Vírgula''' ou '''ponto e vírgula'''.
 +
Ao importar um arquivo de contatos, é possível escolher entre os dois separadores. Alem do campo '''Observações''', é possível associar 5 campos de informações adicionais. O arquivo pode conter os seguintes campos:
 +
 
 +
* Nome
 +
* Telefone
 +
* Informação1
 +
* Informação2
 +
* Informação3
 +
* Informação4
 +
* Informação5
 +
* Observações
 +
<br>
 +
'''Ex (com vírgula):'''
 +
<pre>Joaquim Silvestre,04899998888,12819350000189,Informação2,Informação3,Informação4,Informação5,Observações</pre>
 +
<BR>
 +
'''Ex (com ponto e vírgula):'''
 +
<pre>Joaquim Silvestre;04899998888;12819350000189;Informação2;Informação3;Informação4;Informação5;Observações</pre>
 +
<br>
 +
{| style="width: 100%; background-color: orange;"
 +
|Para '''Sort Code''', os números devem ter o código do país. '''Formato:''' 55 + DDD + NUMERO. Ex. '''554899997777'''
 +
|}
 +
 
 +
<BR><BR>
 +
----
 +
 
 +
= Importando um arquivo CSV =
 +
 
 +
* Acesse o menu Contatos, e clique no botão '''Importar'''
 +
 
 +
[[File:importar0.png|center|800px]]
 +
 
 +
* Selecione o arquivo de contatos
 +
* Se desejar incluir automaticamente um DDD padrão para números de contatos que não possuem o DDD, coloque o código no campo '''"quando não houver prefixo, incluir"'''. Observação: Para Short Code essa opção é desabilitada pois, é necessário que o número seja cadastrado com o cód. do pais (55).
 +
* Defina um grupo para o qual os contatos serão importados. Há opções de '''criar grupo''' ou '''incluir no grupo'''. A opção criar grupo insere os contatos em um grupo que esta sendo criado com o nome digitado. A opção incluir no grupo, permite que os contatos sejam adicionados a um grupo existente ou que os novos contatos substituam os contatos do grupo existente(opção '''limpar grupo'''), mantendo o mesmo nome.
 +
* Selecione o divisor de campos ('''Virgula''' ou '''Ponto e Virgula''') do formato do arquivo que está sendo importado.
 +
* Pressione o botão '''Próximo''' para prosseguir com a instalação.
 +
 
 +
 
 +
[[File:importar1.png|center|1000px]]
 +
 
 +
 
 +
* Neste passo, selecione qual coluna do arquivo pertence a cada informação do contato.
 +
* Pressione o botão '''Próximo''' para prosseguir com a importação.
 +
 
 +
 
 +
[[File:importar2.png|center|1100px]]
 +
<br><br>
 +
-----
 +
 
 +
= Menu Campanhas =
 +
 
 +
* Ao acessar o menu '''Campanhas''', será mostrado todas as campanhas e o status de cada uma delas:
 +
** '''(1)''' - formato da mensagen
 +
** '''(2)''' - Status de envio da campanha.
 +
**** '''Concluída''': Campanha concluída
 +
**** '''Em andamento''': Campanha ainda sendo enviada.
 +
**** '''Pausada''': Campanha pausada, pois o usuário pressionou o botão de pausa '''(3)'''
 +
**** '''Suspensa''': Campanha suspensa, pois o usuário pressionou o botão de '''stop''' '''(3)'''
 +
** '''(3)''' - Botões de controle da campanha.
 +
 
 +
 
 +
[[File:campanha0.png|center|1000px]]
 +
 
 +
<br>
 +
-----
 +
 
 +
= Criando uma Campanha =
 +
 
 +
Acesse o menu '''Campanhas''' e clique no botão '''Novo'''.
 +
 
 +
* Configure os Parâmetos da campanha:
 +
 
 +
{| class="wikitable" width="70%"
 +
! scope="row" colspan=2 style="width: 25%" align="center"| Parâmetros das Campanhas
 
|-
 
|-
−
! scope="row" style="width: 20%" align="right"| '''message_ref'''
+
! scope="row" style="width: 30%" align="right"| Título
−
| Essa parâmetro deve ser salvo! Ele será utilizado para mapear o status de recebimento da mensagem (Status-Report). Ao receber um status-report, o valor do campo '''message_id''' será o mesmo recebido no status de envio mas no campo '''message_ref'''.
+
| Descrição da campanha
 
|-
 
|-
−
! scope="row" style="width: 20%" align="right"| '''status'''
+
! scope="row" style="width: 30%" align="right"| Mensagem
−
| Parâmetro identificando se a mensagem foi aceita pela operadora ( e será enviada ou não)<br\>'''status=sent''' : Envio OK<br\>'''status=error''' : Erro no envio da mensagem<br\>'''status=received''' : Mensagem recebida pelo destino
+
| Edite a mensagem a ser enviada na campanha. Utilize as ''tags'' '''{''' e '''}''' os dados personalizados de cada contato. Ex. {nome}
 
|-
 
|-
−
! scope="row" style="width: 20%" align="right"| '''board'''
+
! scope="row" style="width: 30%" align="right"| Hora Inicial / Hora Final
−
| Parâmetro utilizado para identificar o endereço IP da placa que enviou a mensagem.  
+
| Define os horários que a campanha estará ativa. Fora desse horário a campanha ficara pausada.
 
|-
 
|-
−
! scope="row" style="width: 20%" align="right"| '''interface'''
+
! scope="row" style="width: 30%" align="right"| Vigência Inicial / Vigência Final
−
| Parâmetro utilizado para identificar por qual interface GSM ( 0 ou 1 ) a mensagem foi enviada.
+
| Define a data inicial e a data final (data limite) da campanha. Após a data final, a campanha será finalizada, independente do estado.
 
|-
 
|-
−
! scope="row" style="width: 20%" align="right"| '''sim_card'''
+
! scope="row" style="width: 30%" align="right"| Limite de mensagens por hora
−
| Parâmetro utilizado para identificar por qual Sim Card ( 0 ou 1 ) a mensagem foi enviada.
+
| Define um limite máximo de envios de mensagens por hora.
 
|-
 
|-
−
! scope="row" style="width: 20%" align="right"| '''error'''
+
! scope="row" style="width: 30%" align="right"| Bloqueio de contatos duplicados
−
| Parâmetro utilizado para identificar qual o erro reportado pela operadora no envio de uma mensagem (Somente recebido quando o parâmetro '''status''' for igual a '''sent'''). Ver tabela completa de error em '''[[API_-_SMS/Codigos_de_Erro_-_Operadora]]'''
+
| Bloqueia contato duplicados na importação da campanha, deixando de enviar mensagem repetidas.
 +
|-
 +
! scope="row" style="width: 30%" align="right"| Frequência de envio
 +
|
 +
* Define se a campanha será repetida.<br />
 +
* Envio Único: Campanha será executada somente uma única vez.
 +
* Envio por hora: A campanha será repetida a cada hora.
 +
* Envio diário: A campanha será repetida todo dia.
 +
* Envio semanal: A campanha será repetida semanalmente.
 +
* Discagem mensal: A campanha será repetida mensalmente.
 +
Ver '''NOTA1''' no rodapé.
 +
|-
 +
! scope="row" style="width: 30%" align="right"| Iniciar Autonomamente
 +
| Se selecionado, inicia a campanha automaticamente.
 +
|-
 +
! scope="row" style="width: 30%" align="right"| Prioridades de discagem
 +
| É possível criar de prioridade de discagem na campanha por expressões regulares. Ex: Selecionamos ''''Prioridade 1''' e colocamos a expressão regular '''0119........'''<br />Com essa expressão, todas as chamadas para celulares do DDD 11 terão prioridade sobre os outros números. '''Ver NOTA2'''
 +
|-
 +
! scope="row" style="width: 30%" align="right"| Limite de chamadas por hora
 +
| Este campo serve para limitar a quantidade de chamadas por hora que a campanha realizará. Se configurado 0 (zero), não terá limite de chamadas.
 +
|-
 +
! scope="row" style="width: 30%" align="right"| Limite máximo de chamadas
 +
| Número máximo de ligações simultâneas que esta campanha realizará. Caso a campanha esteja configurado como '''Tipo URA'', esse campo será o número máximo de chamadas na URA.
 +
|-
 +
! scope="row" style="width: 30%" align="right"| Prioridade
 +
| Define a prioridade desta campanha entre todas as campanhas ativas. Zero - Sem prioridade. 10 - Maior prioridade.
 +
|-
 +
! scope="row" style="width: 30%" align="right"| Iniciar Automaticamente.
 +
| Se selecionado ('''Verde'''), inicia a campanha automaticamente ao criá-la. Caso contrário, deverá ser iniciada manualmente pelo botão ''play'' da campanha.
 +
|-
 +
! scope="row" style="width: 30%" align="right"| Validar.
 +
| Botão utilizado para validar a mensagem da campanha, sendo possível enviar mensagens de testes para números de testes. O número é inserido de teste é inserido após validação.
 
|}
 
|}
  
 +
[[File:addcamp0.png|center|600px]]
 +
<br>
  
−
= Formato dos Arquivos CSV =
+
* Selecione o(s) Grupo(s) de contatos para envio.
 +
 
 +
[[File:addcamp1.png|center|700px]]
 +
 
 +
* Configure o envio de mensagens automáticas, no caso re respostas das mensagens
 +
 
 +
[[File:addcamp2.png|center|700px]]
 +
 
 +
* Pressione o botão "Salvar" para criar a campanha. Se a opção '''Iniciar Automaticamente''' estiver selecionada, a campanha será iniciada.
 +
<br>

Edição atual tal como 13h31min de 29 de junho de 2017

Utilizando a plataforma SMS

Tabela de conteúdo

[editar] Visão Geral

[editar] Login

Para acessar a plataforma, acesse o link: [1]

Entre com login e senha e pressione o botão Login

Login.png

[editar] Dashboard

Ao acessar o equipamento, será apresentado a tela de 'Dashboard, com as principais informações do sistema.


Dashboard.png


[editar] Menu

Menu.png


Abaixo a lista de opções do menu da plataforma SMS.


Opções do Menu
Inicio: Link para o dashboard' do sistema
Contatos: Menu de gerenciamento e importação de contatos
Grupos: Menu de configuração, criação e remoção dos grupos de contatos
Blacklist: Menu configuração dos números inseridos na 'Blacklist.
Mensagens: Menu de mensagens Recebidas.
Campanhas: Menu de acesso e configuração as campanhas.
Recarga: Menu para solicitar nova recarga de mensagens.
Relatório: Menu de relatórios de envio e recebimento de mensagens.
Estatísticas: Acesso as estatísticas de envio e recebimento de mensagens , por Canal GSM /SIM Card (Quando utilizado Gateway uTech).
Configuração: Menu de configuração do servidor de e-mail e mapeamento de erros.






[editar] Formato dos Arquivos CSV

Os arquivos para importação dos contatos, deverão ser no formato texto (CSV) e com campos separados por Vírgula ou ponto e vírgula. Ao importar um arquivo de contatos, é possível escolher entre os dois separadores. Alem do campo Observações, é possível associar 5 campos de informações adicionais. O arquivo pode conter os seguintes campos:

  • Nome
  • Telefone
  • Informação1
  • Informação2
  • Informação3
  • Informação4
  • Informação5
  • Observações


Ex (com vírgula): 

Joaquim Silvestre,04899998888,12819350000189,Informação2,Informação3,Informação4,Informação5,Observações


Ex (com ponto e vírgula): 

Joaquim Silvestre;04899998888;12819350000189;Informação2;Informação3;Informação4;Informação5;Observações


Para Sort Code, os números devem ter o código do país. Formato: 55 + DDD + NUMERO. Ex. 554899997777



[editar] Importando um arquivo CSV

  • Acesse o menu Contatos, e clique no botão Importar
Importar0.png
  • Selecione o arquivo de contatos
  • Se desejar incluir automaticamente um DDD padrão para números de contatos que não possuem o DDD, coloque o código no campo "quando não houver prefixo, incluir". Observação: Para Short Code essa opção é desabilitada pois, é necessário que o número seja cadastrado com o cód. do pais (55).
  • Defina um grupo para o qual os contatos serão importados. Há opções de criar grupo ou incluir no grupo. A opção criar grupo insere os contatos em um grupo que esta sendo criado com o nome digitado. A opção incluir no grupo, permite que os contatos sejam adicionados a um grupo existente ou que os novos contatos substituam os contatos do grupo existente(opção limpar grupo), mantendo o mesmo nome.
  • Selecione o divisor de campos (Virgula ou Ponto e Virgula) do formato do arquivo que está sendo importado.
  • Pressione o botão Próximo para prosseguir com a instalação.


Importar1.png


  • Neste passo, selecione qual coluna do arquivo pertence a cada informação do contato.
  • Pressione o botão Próximo para prosseguir com a importação.


Importar2.png



[editar] Menu Campanhas

  • Ao acessar o menu Campanhas, será mostrado todas as campanhas e o status de cada uma delas:
    • (1) - formato da mensagen
    • (2) - Status de envio da campanha.
        • Concluída: Campanha concluída
        • Em andamento: Campanha ainda sendo enviada.
        • Pausada: Campanha pausada, pois o usuário pressionou o botão de pausa (3)
        • Suspensa: Campanha suspensa, pois o usuário pressionou o botão de stop (3)
    • (3) - Botões de controle da campanha.


Campanha0.png


[editar] Criando uma Campanha

Acesse o menu Campanhas e clique no botão Novo.

  • Configure os Parâmetos da campanha:
Parâmetros das Campanhas
Título Descrição da campanha
Mensagem Edite a mensagem a ser enviada na campanha. Utilize as tags { e } os dados personalizados de cada contato. Ex. {nome}
Hora Inicial / Hora Final Define os horários que a campanha estará ativa. Fora desse horário a campanha ficara pausada.
Vigência Inicial / Vigência Final Define a data inicial e a data final (data limite) da campanha. Após a data final, a campanha será finalizada, independente do estado.
Limite de mensagens por hora Define um limite máximo de envios de mensagens por hora.
Bloqueio de contatos duplicados Bloqueia contato duplicados na importação da campanha, deixando de enviar mensagem repetidas.
Frequência de envio
  • Define se a campanha será repetida.
  • Envio Único: Campanha será executada somente uma única vez.
  • Envio por hora: A campanha será repetida a cada hora.
  • Envio diário: A campanha será repetida todo dia.
  • Envio semanal: A campanha será repetida semanalmente.
  • Discagem mensal: A campanha será repetida mensalmente.

Ver NOTA1 no rodapé.

Iniciar Autonomamente Se selecionado, inicia a campanha automaticamente.
Prioridades de discagem É possível criar de prioridade de discagem na campanha por expressões regulares. Ex: Selecionamos 'Prioridade 1 e colocamos a expressão regular 0119........
Com essa expressão, todas as chamadas para celulares do DDD 11 terão prioridade sobre os outros números. Ver NOTA2
Limite de chamadas por hora Este campo serve para limitar a quantidade de chamadas por hora que a campanha realizará. Se configurado 0 (zero), não terá limite de chamadas.
Limite máximo de chamadas Número máximo de ligações simultâneas que esta campanha realizará. Caso a campanha esteja configurado como 'Tipo URA, esse campo será o número máximo de chamadas na URA.
Prioridade Define a prioridade desta campanha entre todas as campanhas ativas. Zero - Sem prioridade. 10 - Maior prioridade.
Iniciar Automaticamente. Se selecionado (Verde), inicia a campanha automaticamente ao criá-la. Caso contrário, deverá ser iniciada manualmente pelo botão play da campanha.
Validar. Botão utilizado para validar a mensagem da campanha, sendo possível enviar mensagens de testes para números de testes. O número é inserido de teste é inserido após validação.
Addcamp0.png


  • Selecione o(s) Grupo(s) de contatos para envio.
Addcamp1.png
  • Configure o envio de mensagens automáticas, no caso re respostas das mensagens
Addcamp2.png
  • Pressione o botão "Salvar" para criar a campanha. Se a opção Iniciar Automaticamente estiver selecionada, a campanha será iniciada.


Obtida de "https://wiki.utech.com.br/wiki/index.php?title=Plataforma_-_SMS&oldid=3368"
Ferramentas pessoais
Espaços nominais

Variantes
Visualizações
Ações
Navegação
Ferramentas