Enviar SMS por email

Com a Mail API envia SMS diretamente a partir do seu programa de email ou de qualquer aplicação capaz de enviar emails. O requisito é uma configuração Mail API. O artigo Configurar a Mail API descreve como a criar.

Endereço

Cada configuração tem um endereço fixo, que encontra no dashboard em Programador -> Acessos à API:

TOKEN@gateway.seven.io
PREFIX.TOKEN@gateway.seven.io

O token é gerado pela seven e mantém-se fixo. O prefixo escolhe-o livremente em cada email: tudo o que está antes do último ponto do endereço é o prefixo e é avaliado através do padrão do prefixo de endereço.

Se o padrão do prefixo de endereço for {{to}}, um email para 4917612345678.a1b2c3d4e5f6g7h8@gateway.seven.io vai para o número de telefone 4917612345678. Em vez de um número de telefone, também pode indicar um contacto ou um grupo do seu livro de endereços.

Se tiver ativado na configuração a opção Permitir adicionalmente o endereço sem token, basta o prefixo: 4917612345678@gateway.seven.io.

Destinatário, texto e remetente

Onde se encontram no email o destinatário, o texto da mensagem e o remetente, é algo que define com os padrões da configuração:

• Destinatário: através de {{to}} no prefixo, no assunto ou no corpo. Se nenhum padrão capturar o destinatário, o SMS vai para o destinatário fixo da configuração.
• Texto: na predefinição (padrão do corpo {{text}}), todo o texto do email passa a ser o SMS. Com texto literal no padrão delimita o texto, por exemplo (({{text}})), para que as assinaturas não sejam enviadas.
• Remetente: através de {{from}} num padrão ou através do remetente da mensagem definido na configuração. Se ambos estiverem vazios, aplica-se o remetente predefinido da sua conta.

Outras opções, como a hora de envio ({{delay}}), uma etiqueta ({{label}}) ou um SMS flash ({{flash}}), também são controladas através de variáveis nos padrões. Os parâmetros de controlo no assunto, como from= ou key=, não são avaliados em configurações com endereço fixo. A lista completa das variáveis encontra-se na documentação da Mail API.

Um exemplo: uma ferramenta de monitorização envia o seu alerta no assunto para a1b2c3d4e5f6g7h8@gateway.seven.io. Na configuração, o padrão do assunto é {{text}}, o padrão do corpo está vazio e o seu número de piquete está introduzido como destinatário fixo. O assunto Carga de CPU crítica em srv-07 dá então origem a um SMS com exatamente este texto para o número de piquete.

Endereço do remetente

Envie sempre a partir de um dos remetentes permitidos da configuração. Os emails de outros endereços não são processados. Se a verificação DMARC estiver ativa para a configuração, o seu email tem também de passar nessa verificação. Os emails rejeitados aparecem com o código 904 no Debugger.

Formato clássico (configurações Legacy)

As configurações criadas antes da introdução do endereço fixo estão assinaladas no dashboard com Legacy e continuam a funcionar sem alterações. Aqui controla o envio através da linha do destinatário e do assunto:

• Destinatário: número de telefone antes de @gateway.seven.io, por exemplo 01761234567890@gateway.seven.io.
• Assunto: comandos no formato parametro=valor, separados por espaços, por exemplo from=Florista key=123456789. Os valores com espaços são colocados entre aspas: from="Casa das Flores". Um to= no assunto substitui a linha do destinatário, o que permite, por exemplo, chegar também a grupos.
• Texto: o texto do email. Se o delimitar com cardinais duplos (##Este é o seu texto##), só é enviada a parte entre eles.

Todos os parâmetros do formato clássico encontram-se na documentação da Mail API.