Limpar os números de telefone da sua base de clientes antes de enviar SMS transaccionais

WhatsApp e APIs·· 28 visualizações· 3 min de leitura

A resposta curta: antes de ligar o seu sistema ao SMS, arrume os telefones da base de clientes: um formato só, sem espaços nem sinais, sem fixos, sem repetidos e com um número principal por cliente. A API aceita números com ou sem o indicativo, porque o sistema reconhece o país pelo primeiro algarismo: 841234567 vai para Moçambique e 923456789 para Angola. Assim, +258 84 123 4567 e 258841234567 são o mesmo número que 841234567. Mesmo assim, uma base limpa poupa erros invalid_number, créditos e avisos que vão parar à pessoa errada.

O que a API aceita

Número O que acontece
Telemóvel de Moçambique ou de Angola, com ou sem indicativo, com ou sem espaços É reconhecido sozinho e segue.
Outro número sem indicativo Segue o país da sua conta.
Número de um país para onde o serviço não envia A API responde 422 com country_not_available.
Número incompleto ou com letras A API responde 422 com invalid_number.
Número na lista da conta de quem não recebe A API responde 422 com number_opted_out.

Arrumar a base, passo a passo

1 Tire tudo o que não é algarismo: espaços, pontos, traços, parênteses e o sinal +.
2 Escolha um formato e guarde todos assim, de preferência com o indicativo do país. Um número com indicativo não deixa dúvidas, venha de onde vier.
3 Separe fixos de telemóveis. Um telefone fixo não recebe SMS: guarde-o noutro campo, para chamadas.
4 Junte os repetidos. O mesmo cliente com o número escrito de três maneiras dá três SMS.
5 Marque um número principal por cliente, para os avisos irem sempre para o mesmo.

Um exemplo em Python

import re

def limpar(numero):
n = re.sub(r"\D", "", numero or "")
if n.startswith("00"):
n = n[2:]
if len(n) == 9 and n[0] in "89":
return n
if len(n) == 12 and n[:3] in ("258", "244"):
return n
return None # para rever à mão

O exemplo aceita os telemóveis de nove algarismos, com ou sem o indicativo de Moçambique ou de Angola, e põe de parte o resto para alguém rever. Adapte-o à sua base: o que importa é que nenhum número duvidoso chegue à API sem ser visto.

Os números mudam de dono. Um cliente antigo pode ter deixado o número, e o aviso seguinte chega a outra pessoa. Peça aos clientes que actualizem o telefone e, num aviso com dados, prefira o mínimo: o que nunca pôr num SMS.
Para os contactos do SMS Center, a importação em CSV aceita listas da sua base, e um número não se repete na conta. Veja contactos e grupos.

Base limpa, avisos certos: veja como funciona o SMS Transaccional.

Ver o SMS Transaccional

VEJA TAMBÉM

Contactos e grupos de SMS: importar uma lista em CSV e mantê-la limpa

Erros e estados das mensagens na API de SMS: o que significa cada um e o que fazer

O que nunca pôr num SMS transaccional: senhas, números de cartão completos e dados privados

Estatísticas e relatórios de SMS pela API: totais por estado, créditos gastos e dias

Boas práticas e consentimento no SMS: a quem pode enviar e como deixar sair

Casos de teste do SMS transaccional na Sandbox: números errados, textos longos, saldo e repetições

PRODUTO RECOMENDADO

Hospedagem de sites com cPanel

Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde 5.940,00 Kz/mês (plano de 3 anos, com cupão)

Ver planos
Esta resposta foi útil? A sua resposta ajuda-nos a melhorar este artigo.