seven CLI

Com a ferramenta seven-cli, você tem à sua disposição uma solução eficiente para enviar SMS diretamente do seu console ou terminal sem complicações. Esta poderosa ferramenta não requer integração com a API, pois funciona através da comunicação direta com nosso gateway via HTTP-API.

Você pode baixar o seven-cli facilmente e utilizá-lo imediatamente após o download, sem instalação, através da sua interface de linha de comando para enviar mensagens SMS. A ferramenta é compatível e foi testada com os sistemas operacionais Windows XP, Windows 7, macOS, Raspberry Pi e Ubuntu.

Para personalização, o seven-cli oferece dois modos de uso: você pode passar os parâmetros necessários diretamente como parâmetros ou pré-definir suas configurações no arquivo config.ini. Essa flexibilidade torna o seven-cli uma ferramenta especialmente amigável para o envio rápido e descomplicado de SMS.

Download

Atualmente, fornecemos builds compilados para Windows, Linux e OSX. Se você precisar do seven-cli para outro sistema operacional, por favor, envie-nos um e-mail.

Windows

Baixar

macOS

Baixar

Raspberry PI

Baixar

Linux

Baixar

Parâmetros

Parâmetros Necessários

--apikey SUA_CHAVE_API. Crie agora sua chave API.

--to Destinatário do SMS. São possíveis nomes de contato e números de telefone em qualquer formato.

--text O texto do SMS.

Parâmetros Opcionais

--sender Remetente do SMS. Este pode conter até 11 caracteres alfanuméricos ou 16 caracteres numéricos.

--flash O SMS deve ser enviado como Flash SMS. Estes são exibidos diretamente na tela do destinatário. 1 = Flash SMS / 0 = SMS Normal (Padrão)

--delay Timestamp para quando o SMS deve ser enviado.

--udh Unique Data Header

--ttl Período de validade em minutos (Padrão: 2880)

--label Opcionalmente, defina um rótulo para cada SMS para poder identificá-las em suas estatísticas. Máx. 100 caracteres, caracteres permitidos: a-z, A-Z, 0-9, .-_@.

--performance_tracking Ativar rastreamento de cliques e desempenho para URLs encontradas no texto SMS. Isso também ativa o encurtador de URL.

--foreign_id Forneça seu próprio ID para esta mensagem. Você receberá o foreign_id de volta em callbacks para relatórios de status, etc. Máx. 64 caracteres, caracteres permitidos: a-z, A-Z, 0-9, .-_@.

--logfile Caminho para o arquivo de log. Se o arquivo não existir, ele será criado.

--config Caminho para o arquivo de configuração. Se um parâmetro for especificado como argumento na chamada e no arquivo de configuração, o argumento será preferido.

--help Exibe ajuda sobre a chamada e os argumentos.

--version Exibir informações da versão da ferramenta.

Arquivo de Configuração

Aqui está um exemplo de um arquivo de configuração incluindo todas as opções disponíveis.

Criar chave de API

[Benutzerdaten]
apikey      = "abcdef123456...."    # Gateway API Schlüssel
logfile     = logfile.txt           # Name und Pfad des Logfiles. Leerlassen um Log zu deaktiveren

[SMS]
# In diesem Bereich können Sie einige Default Parameter eingeben. Diese werden immer dann 
# verwendet, wenn seven-cli der jeweilige Parameter nicht übergeben wird 
empfaenger  = 49176123456789        # Default Empfänger oder Gruppe
flash       = 0                     # 1 = Flash / 0 = kein Flash
smstext     = "Hallo Welt"          # SMS Text
absender    = "Alarm"               # Absender der SMS

# Weitere Einzelheiten zu den Parametern finden Sie hier https://docs.seven.io/en/rest-api/endpoints/sms
delay = 10
udh = ""
ttl = 2880
label = "somelabel"
performance_tracking =        # 1 | 0
foreign_id = "myid"  

[Probealarm]
start       = 22:51                 # Innerhalb dieses Zeitfensters werden keine SMS verschickt
ende        = 23:20

Nível de Erro

seven-cli retorna diretamente o nível de erro como feedback. Assim, você pode, por exemplo, em seu arquivo batch, proceder dependendo se o envio do SMS foi bem-sucedido.

seven-cli --apikey ... && echo "SMS foi enviado"

Exemplo

Isso envia um SMS para 01761234567890 com o texto Aqui está o texto do SMS e remetente EmpresaABC. Para simplificar, você pode armazenar, por exemplo, seu nome de usuário e sua chave de API no config.ini.

seven-cli \
  --apikey IHR_API_SCHLÜSSEL \
  --to 01761234567890 \
  --text "Hier der SMS Text" \
  --sender FirmaABC

Changelog

Versão 1.8 - 11.02.2025

  • Parâmetros delay, udh, ttl, label, performance_tracking e foreign_id foram adicionados.

Versão 1.7 - 10.04.2020

  • Renomeação para seven-cli
  • Parâmetro Tipo de SMS foi removido
  • Pequenas otimizações

Versão 1.6 - 28.02.2019

  • Otimização de desempenho especialmente para SMS em massa
  • Parâmetro --to agora pode referir-se a um arquivo de texto que contém os números de telefone
  • Tipo de SMS Básico removido

Versão 1.5 - 31.01.2019

  • Correções menores de erros na comunicação com o Gateway de SMS

Versão 1.4 - 28.12.2018

  • Parâmetro --user não é mais necessário na API de SMS. Por favor, use apenas a SUA_CHAVE_API.

Versão 1.3 - 13.01.2017

  • Ajustes devido ao relançamento do sms77.io

Versão 1.2 - 16.09.2016

  • O parâmetro config foi adicionado.

Versão 1.1 - 07.09.2015

  • Horários de alarme de teste configuráveis
  • Arquivo de log
  • Opção de depuração
  • Nível de erro

Versão 1.0 - 14.05.2015

  • Lançamento da ferramenta