Mudanças entre as edições de "Controllr/Aplicativos/Cadastros/Messenger/SMS/Apis"

De BrByte Wiki
(Criou página com '=Messenger Apis= No App Messenger Apis link= O aplicativo Messenger Apis permite realizar a conexão com as plataformas de envio de mensagen...')
 
Linha 55: Linha 55:
 
|-
 
|-
 
! style="text-align:left; vertical-align:middle;"| Url
 
! style="text-align:left; vertical-align:middle;"| Url
| style="text-align:left; vertical-align:middle;"| Deve ser inserido a URL com os parâmetros corretos para ser enviado o SMS do gateway contratado.<br>Cada gateway possui um padrão que deve ser verificado na documentação da API.<br><br>Você poderá utilizar algumas palavras chaves que o sistema Controllr utilizará para recuperar as informações através de variáveis. Temos:<div style="border:double; border-color: black;">• <font style="color:red; font-size:14pt;">'''{u}'''</font>: Puxa o nome do usuário cadastrado na configuração do seu gateway de envio<br>• <font style="color:red; font-size:14pt;">'''{p}'''</font>: Puxa a senha cadastrada na configuração do seu gateway de envio<br>• <font style="color:red; font-size:14pt;">'''{d}'''</font>: Puxa o número que será enviado o SMS do cadastro do seu cliente<br>• <font style="color:red; font-size:14pt;">'''{m}'''</font>: Puxa a mensagem que será enviada dos modelos de envio</div>  
+
| style="text-align:left; vertical-align:middle;"| Deve ser inserido a URL com os parâmetros corretos para ser enviado o SMS do gateway contratado.<br>Cada gateway possui um padrão que deve ser verificado na documentação da API.<br><br>Você poderá utilizar algumas palavras chaves que o sistema Controllr utilizará para recuperar as informações através de variáveis. Temos:<br><br><div style="border:double; border-color: black;">• <font style="color:red; font-size:14pt;">'''{u}'''</font>: uma variável aleatória que pode ser usada como nome de usuário cadastrado.<br>• <font style="color:red; font-size:14pt;">'''{p}'''</font>: uma variável aleatória que, normalmente, é usada como senha.<br>• <font style="color:red; font-size:14pt;">'''{t}'''</font>: uma variável aleatória que pode ser usada como uma chave de token.<br>• <font style="color:red; font-size:14pt;">'''{d}'''</font>: Variável que puxará automaticamente o número de telefone do cliente que será enviado a mensagem.<br>• <font style="color:red; font-size:14pt;">'''{m}'''</font>: Variável que puxará automaticamente a mensagem dos modelos de envio que será enviada ao cliente.</div><br><br> Essas variáveis aleatórias são preenchidas na categoria abaixo denominada Autorização.
 
| style="text-align:left; vertical-align:middle;"| api/simpleSend.ft?user=<font style="color:red; font-size:14pt;">{u}</font>&password=<font style="color:red; font-size:14pt;">{p}</font>&destinatario=<font style="color:red; font-size:14pt;">{d}</font>&msg=<font style="color:red; font-size:14pt;">{m}</font>
 
| style="text-align:left; vertical-align:middle;"| api/simpleSend.ft?user=<font style="color:red; font-size:14pt;">{u}</font>&password=<font style="color:red; font-size:14pt;">{p}</font>&destinatario=<font style="color:red; font-size:14pt;">{d}</font>&msg=<font style="color:red; font-size:14pt;">{m}</font>
 +
|-
 +
! style="text-align:center" colspan="3"| Loader
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| Intervalo
 +
| style="text-align:left; vertical-align:middle;"| Defina o intervalo (em segundos) que será enviado uma quantidade X de mensagens ao seus clientes.<br><br>'''Recomendamos a cada 30 segundos enviar 5 mensagens.'''
 +
| style="text-align:left; vertical-align:middle;"| 30
 +
|-
 +
! style="text-align:left; vertical-align:middle;"| Limite
 +
| style="text-align:left; vertical-align:middle;"| Defina quantas mensagens serão disparadas no intervalo definido acima.
 +
| style="text-align:left; vertical-align:middle;"| 5
 
|-
 
|-
 
|}
 
|}

Edição das 10h42min de 8 de fevereiro de 2023

Messenger Apis

No App Messenger Apis Dev-sms-campaign.png

O aplicativo Messenger Apis permite realizar a conexão com as plataformas de envio de mensagens. A seguir, mostraremos como configurá-la para várias plataformas diferentes.

Controllr-aplicativos-cadastros-messenger-apis.png


Para adicionar uma nova Api, basta clicar no botão Add.png Novo.

Novo

Nesta sessão, ensinaremos o passo a passo para conectar suas Apis com o nosso sistema. Essa API poderá ser qualquer uma de sua preferência desde que disponibilize o envio dos SMS via API com a montagem de uma URL de disparo. Conforme a imagem abaixo, algumas informações devem ser preenchidas.

Controllr-aplicativos-cadastros-messenger-apis-novo.png


Novo Genétrico/Outros
Campo Descrição Exemplo
Nome Descreva um nome para a sua aplicação que está sendo cadastrada. Api SMS
Serviço Selecione um dos serviços disponíveis de gateway que irá contratar. Genérico/Outros
Habilitado Habilita ou desabilita para aparecer nas listas de APIs disponíveis.
Método Seleciona o método de envio que o Controllr enviará para a API. As opção são: GET e POST. GET
Acesso
Host Informe o site aonde será iniciado a comunicação do envio via API com o gateway contratado. api.facilitamovel.com.br
Host Informe a porta que o Controllr deve comunicar-se com o Host do gateway contratado.

Por exemplo: As portas 80 e 443 são as portas padrão para HTTP e HTTPS respectivamente.
80
SSL Marque se a comunicação do Controllr com o Host será com criptografia SSL ou não.

Os sites que configurarem um certificado SSL/TLS podem utilizar o protocolo HTTPS para estabelecer uma comunicação segura com o servidor.
Url Deve ser inserido a URL com os parâmetros corretos para ser enviado o SMS do gateway contratado.
Cada gateway possui um padrão que deve ser verificado na documentação da API.

Você poderá utilizar algumas palavras chaves que o sistema Controllr utilizará para recuperar as informações através de variáveis. Temos:

{u}: uma variável aleatória que pode ser usada como nome de usuário cadastrado.
{p}: uma variável aleatória que, normalmente, é usada como senha.
{t}: uma variável aleatória que pode ser usada como uma chave de token.
{d}: Variável que puxará automaticamente o número de telefone do cliente que será enviado a mensagem.
{m}: Variável que puxará automaticamente a mensagem dos modelos de envio que será enviada ao cliente.


Essas variáveis aleatórias são preenchidas na categoria abaixo denominada Autorização.
api/simpleSend.ft?user={u}&password={p}&destinatario={d}&msg={m}
Loader
Intervalo Defina o intervalo (em segundos) que será enviado uma quantidade X de mensagens ao seus clientes.

Recomendamos a cada 30 segundos enviar 5 mensagens.
30
Limite Defina quantas mensagens serão disparadas no intervalo definido acima. 5