Minha Conta

SMS Gateway | Instalação e Documentação

11 de janeiro de 2024 rgato
Let’s Talk BR

Você Precisa Saber...

Com esta aplicação você pode facilmente transformar seu celular no Gateway SMS para suas aplicações.

Você obterá o painel de administração e o aplicativo Android com este pacote. O Painel de Administração monitora todas as mensagens que você enviou usando esta API e o aplicativo Android transforma seu celular em SMS Gateway. Todas as solicitações que você enviar serão primeiro armazenadas no Servidor usando o Painel de Administração e depois serão entregues ao aplicativo Android. O aplicativo android envia o SMS de acordo com a solicitação e reporta o status das mensagens ao Painel Administrativo.

Características

  • Envie SMS a partir de seu aplicativo desenvolvido em qualquer linguagem de programação.
  • Use um arquivo CSV ou Excel contendo números e mensagens nas duas primeiras colunas para enviar mensagens em massa.
  • Mostra o status das mensagens enviadas usando o SMS Gateway no Painel de Administração.
  • Capacidade de receber mensagens no Painel de Administração e respondê-las usando um WebHook.
  • Capacidade de fazer login usando vários dispositivos Android para dividir mensagens entre eles ao enviar mensagens em massa.
  • Capacidade de criar outros usuários para permitir que eles usem o SMS Gateway em seus telefones celulares.

Você precisará de hospedagem na web com a seguinte configuração para executar este aplicativo.

  • Apache ou Nginx
  • PHP 8.1 ou superior
  • MySQL

Você também precisará das seguintes extensões PHP habilitadas.
A extensão a seguir é necessária para que o aplicativo funcione corretamente.

  • php_curl
  • php_gd2 (se não for
  • compilado)
  • php_json
  • php_mbstring
  • php_mysqli
  • php_xml
  • php_zip

É recomendado usar VPS ou Hospedagem Dedicada para SMS Gateway, mas também deve funcionar perfeitamente em Hospedagem Compartilhada. Se você decidir optar pela hospedagem compartilhada, certifique-se de que seu host permita a hospedagem do aplicativo SMS Gateway. Alguns hosts como HostGator e iPage não permitem isso, então é mais provável que bloqueiem o aplicativo.

Você precisará de um dispositivo Android com a seguinte configuração para executar este aplicativo.

  • Android 5.0 ou superior. Você precisará de um dispositivo com Android 5.1 ou superior se quiser enviar SMS de um SIM não padrão.
  • Dispositivo com 2 GB ou mais de RAM. Funciona em dispositivos com especificações mais baixas, mas você pode experimentar degradação do desempenho.
  • Um dispositivo com Google Play Services. Se o seu dispositivo tiver Google Play Store, isso significa que ele possui Google Play Services.

Instalação

Esta etapa é opcional, mas recomendada. Firebase é um serviço gratuito com uso ilimitado, portanto não haverá problemas se você decidir usá-lo. Você só deve evitar esta etapa nos seguintes cenários.

  • Você planeja usar dispositivos que não possuem o Google Play Services (Google Play Store).
  • É necessário criar um APK personalizado para usar o aplicativo com Firebase. Se você não deseja criar um APK personalizado, pule esta etapa.
  • Você não quer que seu aplicativo dependa de serviços de terceiros, como o Firebase.

 

Você será solicitado a acessar o projeto Firebase criado nesta etapa para criar um APK personalizado, portanto, lembre-se de suas credenciais de login.

Assista o Vídeo até o final para fazer o Download do JSON

  1. Extraia o arquivo zip que você recebeu na pasta “Pacote” para uma pasta chamada “smsgateway” ou o nome de sua escolha. Faça upload dessa pasta para o seu servidor e abra o URL que aponta para essa pasta.

  2. Por exemplo, se o seu nome de domínio for “https://example.com” e você carregou a pasta chamada “smsgateway”, seu URL deverá ser “https://example.com/smsgateway”.

  3. Você verá a página a seguir ao carregá-la pela primeira vez. Insira as informações apropriadas no formulário, selecione o fuso horário desejado e clique em “Instalar.

  4. Nota: – O usuário que você criará na instalação terá uma função de administrador. Como administrador você pode criar novos usuários. Esses usuários podem fazer login usando seu celular e usar a funcionalidade SMS Gateway. Como usuário administrador, você pode ver todas as mensagens enviadas por seus usuários.

Let’s Talk BR

Depois de concluir a instalação com êxito, serão apresentadas instruções solicitando que você configure um cron job. A configuração de um cron job é necessária para que algumas funcionalidades funcionem corretamente. Se você estiver usando Cpanel ou Vesta Control Panel, poderá configurá-lo conforme mostrado nas imagens abaixo.

CPanel

Let’s Talk BR

Vesta

Let’s Talk BR

Agora, para começar a usar o SMS Gateway, você só precisa fazer login no aplicativo móvel. Primeiro instale o aplicativo Android neste link.

Agora abra o aplicativo no seu celular e digite os seguintes dados.
Servidor:

Digite o URL do seu painel de administração.


O URL deve conter declaração de protocolo inicial (http:// ou https://).
Incorreto: seusite.com.br
Correto: https://seusite.com.br

E-mail: Digite o e-mail usado para fazer login no Painel de Administração.
Senha: Digite a senha associada ao e-mail fornecido.

Basta clicar no botão “ENTRAR” após fornecer os detalhes necessários. O painel do painel de administração será aberto após o login bem-sucedido. Agora você está pronto para usar isso como um gateway SMS de seus aplicativos.

Configurando Pagamentos

Você deve primeiro ativar a integração com o PayPal para aceitar pagamentos de seus planos de assinatura. Para isso, você precisará do ID e do segredo do cliente do PayPal. Basta seguir os passos abaixo para obtê-lo.

1. Vá para: Painel do desenvolvedor do Paypal e faça login com as credenciais da sua conta comercial do PayPal.

2. Você verá a opção Sandbox e Live. Basta clicar na opção Ao vivo e depois clicar no botão “Criar aplicativo” conforme destacado na imagem a seguir.

Let’s Talk BR

3. Você verá o seguinte formulário. Basta digitar o nome desejado no campo “Nome do aplicativo” e clicar no botão “Criar aplicativo”.

Let’s Talk BR

4. Você verá o seguinte formulário. Basta clicar em “Mostrar” e copiar o ID do cliente e o segredo.

Let’s Talk BR

5. Agora que você tem o ID do cliente e o segredo, poderá ativar a integração com o PayPal. Basta fazer login na sua conta de administrador e ir para a página Configurações. Primeiro verifique se você tem o nome e a descrição do site corretos. O Paypal usa-os para a fatura e depois de inserir o ID e o segredo do cliente Paypal você não poderá alterá-lo. Agora, basta clicar na aba Gateway de Pagamento. Depois disso, ative a opção conforme mostrado na imagem a seguir e insira seu ID de cliente e segredo.

Let’s Talk BR

Para mostrar planos de assinatura aos usuários, você deve criá-los. Basta acessar a página Planos após fazer login em sua conta de administrador e preencher o formulário Adicionar plano conforme mostrado abaixo. Se você não inserir nenhum limite, o recurso será ilimitado para esse plano. Não é possível alterar o nome, o preço, a moeda e a frequência do plano no PayPal depois de criá-lo, portanto, escolha-o com sabedoria.

Let’s Talk BR

Depois de criar os Planos, você pode alterar seus limites a qualquer momento clicando no nome do Plano na tabela Planos conforme destacado abaixo. Se houver um usuário inscrito neste plano, as alterações nos limites do plano entrarão em vigor para ele no próximo ciclo.

O PayPal não permite remover completamente o Plano, mas você pode desativá-lo. O plano desativado não será mostrado aos usuários. Os usuários atualmente inscritos no plano para deficientes permanecerão inscritos, mas novos usuários não poderão assinar este plano.

Let’s Talk BR

Use Servidor SMTP para e-mails

Você pode fornecer o servidor SMTP que deseja usar para enviar e-mails fazendo login em sua conta de administrador. Basta ir à página Configurações e clicar na guia SMTP. Você verá o formulário mostrado na imagem a seguir. O exemplo para adicionar o servidor SMTP do Gmail é mostrado nele. Você pode alterar os valores de acordo com suas necessidades. Se você decidir usar o Gmail como servidor SMTP, será necessário ativar a autenticação de dois fatores em sua conta do Gmail, conforme mostrado aqui , e gerar a senha do aplicativo para usá-la para SMTP . Você pode gerar a senha do aplicativo conforme mostrado aqui . Você pode usar seu e-mail como nome de usuário SMTP e senha do aplicativo gerada como senha SMTP.
 
Nota: – Se o seu SMTP não funcionar por algum motivo, você pode definir Debug como Server. Ele registrará informações mais detalhadas sobre o erro encontrado ao se conectar ao servidor SMTP. Você poderá ver as informações de depuração na guia SMTP da página de configurações. Você verá o link “Mostrar informações de depuração” ao lado de Debug. Você pode clicar nele para ver as informações de depuração SMTP.
 
Let’s Talk BR

Formatando Números de Telefone

Encorajamos fortemente a formatação de números de telefone E.164 para todos os números de telefone. Este é um formato de número de telefone padrão reconhecido internacionalmente que ajudará a garantir a capacidade de entrega de mensagens SMS em todo o mundo.
 
Use um número de telefone formatado em E.164 para enviar mensagens SMS para garantir uma entrega bem-sucedida.
 
Formatação de número de telefone E.164
 
A formatação E.164 para números de telefone envolve o seguinte:
  • Um sinal + (mais)
  • Código de chamada internacional do país
  • Código de área local
  • Número de telefone local
Por exemplo, aqui está um número baseado nos EUA na formatação local padrão: (415) 666-1234
 
Aqui está o mesmo número de telefone no formato E.164: +14156661234
 
No Reino Unido e em muitos outros países a nível internacional, a marcação local pode exigir a adição de um ‘0’ antes do número do assinante. Com a formatação E.164, este ‘0’ geralmente deve ser removido.
 
Por exemplo, aqui está um número baseado no Reino Unido em formato local padrão: 020 1234 5678
 
Aqui está o mesmo número de telefone no formato E.164: +442012345678
 
Ajuda com formatação E.164
 
Se você não tiver certeza do código do país correto, uma boa referência é esta página da Wikipedia que lista os países e seus códigos de chamada .

Obtendo o ID do Dispositivo

Para enviar mensagens para um dispositivo específico, você deve saber o ID do dispositivo que deseja usar. Você pode ver o ID do dispositivo na gaveta de navegação conforme mostrado na imagem abaixo.
 
Let’s Talk BR
 
Como você pode ver na captura de tela acima, o ID do dispositivo é mostrado entre colchetes com o nome do dispositivo.

reCAPTCHA

Basta visitar o site do reCaptcha e fazer login usando sua conta do Google. Clique em Criar (+ ícone) e você verá o formulário como o seguinte.
 
Let’s Talk BR
Basta inserir seu nome de domínio em vez de “example.com”, selecionar outras opções conforme mostrado acima e clicar em enviar. Você receberá a chave secreta e a chave do site conforme mostrado abaixo.
 
Let’s Talk BR
 
Agora, você pode adicionar reCaptcha ao formulário de registro adicionando a chave do site e a chave secreta no arquivo “config.php”, conforme mostrado abaixo.
 
define ( ‘RECAPTCHA_SECRET_KEY’ , ‘Sua chave secreta reCaptcha’ );
define ( ‘RECAPTCHA_SITE_KEY’ , ‘Sua chave do site reCaptcha’ );

Idioma

Você pode adicionar seu arquivo de idioma à pasta “lang” dentro da pasta de recursos. Depois disso, basta ir para a página Configurações após fazer login na sua conta de administrador e alterar o idioma.
 
Por exemplo: – Para traduzir para o francês você só precisa traduzir o arquivo “english.php” da pasta “resources/lang” e salvá-lo como “french.php” dentro da pasta “resources/lang”. Agora você pode alterar o idioma padrão do aplicativo da web para francês alterando o idioma em Configurações após fazer login em sua conta de administrador.
 
Let’s Talk BR
 
Se você deseja remover o arquivo em inglês e não deseja que os usuários mudem para outros idiomas, certifique-se de ter apenas o arquivo de idioma na pasta “resources/lang” e altere a constante PRIMARY_LANGUAGE no arquivo “resources/lang.php” para o nome do arquivo do seu idioma. Por exemplo, se eu quiser que os usuários usem o aplicativo apenas no idioma francês e o nome do arquivo do meu idioma for French.php, terei que alterar a constante em “resources/lang.php” conforme mostrado abaixo.
 
define ( “PRIMARY_LANGUAGE” , “francês” );

Respostas Automáticas

Para que a resposta automática funcione, você deve ativar “Leitura recebida” no aplicativo Android. Você pode ativá-lo na gaveta de navegação.
 
Você pode adicionar respostas automáticas a determinadas mensagens usando a Resposta Automática. Basta clicar na resposta automática no menu de navegação. Você verá um formulário como abaixo.
 
Let’s Talk BR
 
Mensagem é o texto da mensagem recebida para a qual você deseja escrever uma resposta e Resposta é a mensagem que será enviada pelo sistema automaticamente em resposta à mensagem recebida.
 
Responda se é como o sistema determina como comparar a mensagem recebida com a Mensagem. Você pode descobrir o que cada opção significa abaixo.
 
1. Correspondência exata (sem distinção entre maiúsculas e minúsculas) : – Se você selecionar esta opção, o sistema só enviará a mensagem de resposta se a mensagem recebida for igual à Mensagem. O caso será ignorado.
Por exemplo, tenho uma resposta com “Oi” como meu valor de mensagem e se eu receber a mensagem “Oi”, “hI ou” OI “o sistema enviará a resposta, caso contrário não.
 
2. Correspondência exata (diferencia maiúsculas de minúsculas) : – Se você selecionar esta opção, o sistema só enviará a mensagem de resposta se a mensagem recebida for igual à Mensagem. Ele irá comparar o caso também.
Por exemplo, tenho uma resposta com “Oi” como meu valor de mensagem e se eu receber a mensagem “Oi”, o sistema enviará a resposta, caso contrário não.
 
3. Contém : – Se você selecionar este tipo de correspondência, o sistema só enviará a mensagem de resposta se a mensagem recebida contiver o valor Mensagem.
Por exemplo, tenho uma resposta com “Oi” como meu valor de mensagem e se eu receber uma mensagem que contenha “Oi”, “hI ou” OI “em qualquer lugar, o sistema enviará a resposta, caso contrário, não.
 
4. Expressão regular : – Se você selecionar este tipo de correspondência, o sistema só enviará a mensagem de resposta se a mensagem recebida corresponder ao padrão de expressão regular inserido como um valor de mensagem.
Por exemplo, tenho uma resposta com “/.*/s” como meu valor de mensagem e se eu receber alguma mensagem, o sistema enviará a resposta. Isso acontece porque o padrão “/.*/s” corresponde a qualquer coisa que você inserir.
Tags:

Deixe um comentário

O seu endereço de e-mail não será publicado. Campos obrigatórios são marcados com *

Whatsaap:

+55 (96) 98401-7538