Sumário
- Introdução
- Visão geral do SMS transacional
- Página “SMS transacional”
- Enviar por API de SMS
- Painel de estatísticas de SMS
Introdução
Pronto para se conectar com seus clientes onde quer que eles estejam? Com a API de SMS da Mailjet, envie mensagens de texto transacionais para mais de 55 países no mundo todo.
É assim que funciona:
- Deposite fundos na sua conta de SMS e gere seus tokens de acesso
- Envie mensagens transacionais usando a API de SMS
- Veja as estatísticas das suas mensagens no painel de SMS
Este guia se concentrará em sua conta de SMS (gerar tokens, preços e depósitos, painel de estatísticas).
Peça a seu desenvolvedor que leia nosso guia de referência da API de SMS, que explica os métodos, codificação, códigos de erro e instruções sobre como usar nossa API REST.
Visão geral do SMS transacional
Vamos ver alguns aspectos gerais sobre o envio de SMS transacionais:
- Um SMS pode ter até 160 caracteres (em codificação GSM7), e é possível enviar até 5 SMS concatenados (até 765 caracteres) de uma só vez.*
- O limite padrão de envios é de 200 SMS por dia.
- A página da conta de SMS só está disponível em sua conta principal (e não pode ser acessada a partir de subcontas).
- As mensagens SMS não podem ser enviadas para suas listas de contatos. Os SMS só podem ser enviados a pessoas que deram consentimento para receber SMS transacionais e forneceram um número de telefone no formulário de confirmação.
* Material para desenvolvedores: Seção de concatenação de SMS e codificação
Página “SMS transacional”
Para começar, clique em “SMS” no menu principal.
Na página “SMS transacional”, você pode:
- Gerar tokens de acesso
- Ver o seu saldo pré-pago de SMS e depositar dinheiro
- Analisar as estatísticas de SMS dos últimos 3 meses
Gerar tokens de acesso
Para usar a API de SMS, gere um token de acesso, que será usado para autenticação.
Para criar um token de acesso, clique em “Gerar um token”.
Digite um nome único para seu token e depois clique em “Gerar”.
Assim que o token for gerado, copie e salve o valor do token. Para fins de segurança, o valor do token não é armazenado no Mailjet. Após fechar a janela modal, não é possível rever o valor do token.
Você pode gerar no máximo 10 tokens ativos. Para ver ou excluir seus tokens atuais, clique em “Gerenciar tokens”.
Material para desenvolvedores: Como autenticar usando tokens de portador
Preços de SMS
O preço do envio de um SMS transacional depende do país de destino.
Clique em “Verificar as tarifas” para ver o custo de envio de SMS por país. Se você gostaria de enviar para um país que não está listado, abra um chamado de suporte.
Você pode depositar dinheiro (dólar, euro ou libra) na sua conta de SMS a qualquer momento. O depósito mínimo é de um dólar/euro/libra, e os depósitos não são reembolsáveis.
O custo de cada SMS enviado será automaticamente deduzido da sua conta de SMS.
Adicionar dinheiro à sua conta de SMS
Observação: conforme os regulamentos internacionais, é necessário um processo de validação para a primeira compra de SMS com um novo cartão de crédito. Esse processo pode levar até 48 horas. Quando seu pagamento for validado com sucesso, seu cartão de crédito será cobrado, e o dinheiro será depositado na sua conta de SMS.
Na página “SMS transacional”, clique em “Adicionar dinheiro”.
Digite a quantia de dinheiro na moeda desejada que você deseja depositar. Use a calculadora de SMS para estimar quantas mensagens transacionais podem ser enviadas para um país específico. Clique em “Continuar”.
Confirme suas informações de cobrança (etapa 2) e clique em “Continuar”.
No método de pagamento, selecione o cartão de crédito e clique em “Continuar”.
Leia os “Termos de Serviço” e clique na caixa de seleção para confirmar que só podem ser enviados SMS transacionais a contatos que consentiram claramente em receber SMS, e que não fazer isso pode resultar em multa ou cancelamento do serviço.
Quando estiver tudo pronto, clique em “Confirmar seu pedido”.
Só lembrando: se esta for uma compra inicial de SMS em um cartão de crédito novo, o processo de validação pode levar até 48 horas. Enquanto isso, os fundos aparecerão como “pendentes” na sua conta.
Será gerada uma fatura para cada depósito feito na sua conta de SMS, e ela pode ser visualizada no link “Revisar o histórico de cobrança e faturas”.
Moeda da sua conta de SMS
A moeda de seu depósito definirá a moeda de sua conta de SMS. Se você depositar USD, a moeda de sua conta de SMS será definida como USD; se você depositar EUR, a moeda da conta de SMS será definida como EUR. O depósito mínimo é de uma unidade (dólar/euro/libra).
Quando a moeda da sua conta de SMS for trocada com um novo depósito, os fundos existentes na conta não serão convertidos nem transferidos para a moeda nova. Em vez disso, esses fundos voltarão a ser acessíveis quando você trocar a moeda da conta de SMS de volta com um novo depósito (mínimo de uma unidade) nessa moeda.
Por exemplo:
Paulo faz um depósito inicial de US$ 400, e seu saldo pré-pago de SMS mostra US$ 400. Para cada SMS transacional enviado, o custo é automaticamente descontado do saldo pré-pago. Após um mês de envios, ele ainda tem US$ 125 na conta.
Então, Paulo deposita € 200. A moeda do seu saldo pré-pago de SMS é definida como EUR, e o saldo agora é de € 200. Os SMS enviados serão descontados dos € 200.
Os US$ 125 só poderão ser acessados quando Paulo trocar a moeda da conta de volta para USD com um depósito em USD (mínimo de US$ 1).
Enviar por API de SMS
Gerados os tokens de acesso e feito um depósito na sua conta de SMS, você poderá usar a API de SMS para:
- Enviar grandes volumes de SMS
- Recuperar detalhes das mensagens de SMS e estatísticas básicas de envio
- Exportar uma lista de mensagens de SMS
Aqui estão os guias técnicos e recursos de que sua equipe de desenvolvimento precisará para integrar a API de SMS com sucesso:
- Guia de referência da API de SMS
- API de SMS
- Concatenação de SMS e codificação
- Códigos de status de SMS
- Códigos de erro
Painel de estatísticas de SMS
Veja seu desempenho de SMS nos últimos 3 meses, e o status de cada SMS enviado:
- Entregue: o SMS foi entregue no dispositivo do destinatário.
- Entrega pendente: o SMS foi enviado.
- Rejeitado: o SMS não foi entregue (o remetente pode estar na lista de bloqueio, ser inválido ou com número de destino inativo, o destinatário está inscrito em um serviço de “Não perturbe”, a operadora rejeitou a mensagem, etc.). Se foi dada uma razão de erro, ela será exibida na coluna “Detalhes de status”.