Util::SMS - recebimento de códigos por SMS
Visão geral do scraper
Este scraper é utilizado apenas como um componente conectável em outros scrapers onde pode ser necessário passar por uma verificação na forma de inserção de um código de SMS, por exemplo 
SE::Yandex::Register, bem como em scrapers JavaScript personalizados. Para solicitar números e receber códigos de SMS, são utilizados provedores de números virtuais.
O princípio de funcionamento deste scraper consiste em solicitar um número de telefone e receber um código via SMS. O recebimento do SMS e o retorno do código correto dependem exclusivamente do provedor de números virtuais.
Recursos
- Suporte para os seguintes provedores de números virtuais: 5sim.biz, onlinesim.io, sms-activate.io
- Possibilidade de configurar o tempo de espera pelo código
- Possibilidade de especificar uma configuração personalizada para as requisições de API, que será utilizada sobre os valores definidos no scraper
Casos de uso
- Obtenção de códigos SMS em scrapers integrados que exigem verificação através da inserção de um código SMS
- Obtenção de códigos SMS em scrapers JS personalizados
Consultas
Ao fazer chamadas a partir de scrapers JS, recomenda-se ativar skipProxySettingsInheritance
Existem 3 tipos de consultas que este scraper aceita. Abaixo, detalhes sobre cada uma.
Pedido de número
{"action":"getNumber"}
Como resultado, serão retornados o ID do pedido $id e o número de telefone $number
Obtenção do código SMS
{"action":"getCode","id":123456}
No campo id, deve-se indicar o ID do pedido obtido em getNumber (no exemplo acima, é 123456). Como resultado, serão retornados o ID do pedido $id, o número de telefone $number (pode estar vazio em alguns provedores) e o código do SMS $code
Fechamento do pedido
{"action":"closeNumber","id":123456}
No campo id, deve-se indicar o ID do pedido obtido em getNumber (no exemplo acima, é 123456)
Algoritmo geral de funcionamento
- Solicitar um novo número (
getNumber) - Inserir o número recebido onde for necessário
- Solicitar o código SMS (
getCode), utilizando o ID do pedido recebido na resposta de getNumber - Após o recebimento bem-sucedido do código, utilizá-lo onde for necessário
- Fechar o pedido (
closeNumber)
Configurações possíveis
| Parâmetro | Valor padrão | Descrição |
|---|---|---|
| Provider | onlinesim.io | Seleção do provedor de números virtuais |
| API key for provider | Chave de acesso à API do provedor selecionado | |
| Service | Custom service | Serviço que enviará o SMS; para Custom service, o serviço deve ser obrigatoriamente especificado em Custom config for API request de acordo com a documentação do provedor selecionado |
| Custom config for API request | {} | Configuração personalizada para requisições de API. Deve ser um objeto JSON e conter apenas os parâmetros que precisam ser sobrescritos. A lista completa de parâmetros deve ser consultada na documentação do provedor selecionado. |
| Wait time for receiving SMS | 120 | Tempo de espera pelo código SMS |