Twilio

Twilio é um provedor de serviço de conectividade global amplamente utilizado com sede na Califórnia, conhecido por sua confiabilidade e cobertura em muitos países, particularmente EUA, Canadá e Reino Unido.

Para usar o Twilio como gateway de SMS no Navixy, será necessário obter seu ACCOUNT_SID e AUTH_TOKEN (ou API_SID/API_SECRET par), que você pode adquirir registrando uma conta Twilio. Essas credenciais são necessárias para autenticação e devem ser incluídas na configuração JSON do gateway Twilio na 'sms_gates' tabela de 'google' banco de dados.

Configuração JSON do Navixy para Twilio

A configuração JSON do Navixy para Twilio é um conjunto de parâmetros exigidos para configurar o gateway SMS Twilio no Navixy. Esses parâmetros são definidos em formato JSON e armazenados no 'params' campo de 'sms_gates' tabela no 'google' banco de dados.

Configuração recomendada com account_sid e auth_token:

 campo params:
 {
 "account_sid": "ACdc5f132a3c49700934481addd5ce1659",
 "auth_token": "1095175a27d2044c06e1db8577b484f3",
 "enable_status_callback": false
 }
 type: transceiver
 provider: twilio

ou, alternativamente, com account_sid, api_sid, api_secret:

 campo params:
 {
 "account_sid": "ACdc5f132a3c49700934481addd5ce1659",
 "api_sid": "SK12347865ugdfjbdf7845876345",
 "api_secret": "BS12347865ugdfjbdf7845876345",
 "enable_status_callback": false
 }
 type: transceiver
 provider: twilio

Para localizar seu 'account_sid' e 'auth_token' do Twilio, faça login no seu painel do Twilio e clique em 'Show API Credentials' para acessar as informações da sua conta.

Consultas SQL a executar

Para atualizar o banco de dados com as configurações corretas para usar o Twilio como gateway SMS, utilize a seguinte consulta SQL:

INSERT INTO google.sms_gates (type, provider, params, enabled, class_filter) VALUES ('transceiver', 'twilio','{"account_sid": "ACdc5f132a3c49700934481addd5ce1659","auth_token":"1095175a27d2044c06e1db8577b484f3", "enable_status_callback": true}',1,'*');

Número de telefone do remetente

Para configurar o número de telefone fornecido pelo Twilio execute duas consultas SQL adicionais:

UPDATE google.dealers SET master_phone="TWILIO_PHONE", from_sms="TWILIO_PHONE" WHERE dealer_id=1;
INSERT INTO google.sms_gates_to_dealers (dealer_id, gate_id) VALUES (0, 1);

TWILIO_PHONE representa o número de telefone que você alugou da Twilio. A primeira consulta SQL adiciona o número de telefone que será usado no campo 'from' com a API Twilio. A segunda consulta vincula o gateway SMS à conta do revendedor (PaaS).

Mensagens recebidas

Para receber mensagens recebidas via provedor Twilio adicione a seguinte URL na interface de configuração deles:

http://$IPADDR:22000/sms/$GATEID/incoming

Onde

• $IPADDR - é o endereço IP do servidor ou seu nome de domínio

• $GATEID - id do gateway de SMS que está processando mensagens recebidas

• 22000 - porta usada para escutar conexões (valor padrão)

Problemas conhecidos com o Twilio

Ao usar o gateway SMS Twilio com o Navixy, existe um problema potencial com comandos SMS que contêm espaços iniciais. Em alguns casos, o Twilio pode remover esses espaços ao processar a mensagem, o que pode resultar na falha de execução do comando pretendido.

Por exemplo, se você enviar um comando SMS para um dispositivo com um espaço inicial, como " 123456", o Twilio pode remover o espaço e enviar o comando como "123456" para o dispositivo. Se o dispositivo exigir que o espaço esteja presente para reconhecer o comando, ele não será executado corretamente. Isso pode causar confusão e frustração tanto para usuários quanto para administradores do sistema.

Especificamente, esse problema foi confirmado com dispositivos Teltonika e Ruptela quando a senha para proteger a configuração não está definida no dispositivo.

Para evitar esse problema, recomendamos usar provedores de conectividade SMS alternativos, como Vonage ou Textlocal.