Configurar a Mail API

Como configuro o envio de SMS e mensagens RCS através da Mail API?

A Mail API permite-lhe enviar mensagens SMS ou RCS a partir da sua conta de email através do nosso gateway. Para mais detalhes sobre a utilização, consulte os artigos Enviar SMS por email e Enviar RCS por email.

Criar um endereço Mail API

Abra Developer -> API Access. A página lista todas as suas chaves REST API, endereços Mail API e ligações SMPP lado a lado. Clique em Create New no canto superior direito e escolha Mail API.

Página Developer -> API Access com um botão Create New

Na caixa de diálogo Create Mail API Address configure:

  • Email Sender: o endereço de email a partir do qual irá enviar. Também pode usar um wildcard para um domínio inteiro, por exemplo *@seven.io.
  • Key: uma palavra-passe usada como parâmetro key= em cada SMS enviada por email. Apenas letras, dígitos e - _ $. Clique em Regenerate para gerar um novo valor.
  • Error Mail (optional): endereço que deve receber os erros de entrega. Por predefinição usa-se o endereço remetente.

Clique em Save para adicionar o endereço.

Caixa de diálogo Create Mail API Address com os campos Email Sender, Key e Error Mail

Definições adicionais da Mail API

Abra Developer -> Settings e expanda a secção Mail API para ajustar o comportamento de todos os seus endereços Mail API.

Painel de definições da Mail API com as opções Maximum Character Count, Remove Signature, Notification on Error, HTTP Push on Error e Insert Sender in SMS

Maximum Character Count

Limita o comprimento do corpo para que assinaturas ou rodapés acidentais não disparem o seu volume de SMS. 0 desativa o limite. Para um controlo mais rigoroso, delimite a mensagem com cardinais duplos (##Este é o seu texto##) - o que estiver fora é removido antes do envio.

Remove Signature

Filtra os blocos de citação (> como este) antes do envio.

Notification on Error

Ativa notificações por email e/ou push HTTP quando uma tentativa de email-to-SMS falha.

Insert Sender in SMS

Opcionalmente antepõe parte do remetente do email ao texto da SMS:

  • Full Address: por exemplo username@domain.com
  • Local Part (before @): por exemplo username
  • Don't attach: nada é antepostо

ID de remetente predefinido e RCS

Se quiser um nome de remetente fixo em todas as SMS, defina um ID de remetente predefinido (até 11 carateres alfanuméricos). As respostas só são possíveis se o ID for um número de telefone. As mensagens RCS usam sempre o nome de remetente registado com o agente.

Documentação

Referência completa e exemplos na documentação da Mail API.

Isto respondeu à sua pergunta?

Artigos relacionados