Twilio SMS
Use para trabalho com números de telefone e SMS do Twilio: criar/comprar números, listar números possuídos, manter/rotular números, enviar textos e verificar mensagens recebidas e enviadas.
Segurança
- Nunca imprima Account SIDs, auth tokens, segredos de API, códigos TOTP ou JSON completo de itens do 1Password.
- Não armazene números de telefone reais, SIDs, nomes ou IDs de itens específicos da conta nesta skill.
- Use
$one-passwordpara leitura de segredos.oppermanece apenas no tmux. - Se for necessário acesso ao 1Password desktop, desative a autenticação do service account para esses comandos:
env -u OP_SERVICE_ACCOUNT_TOKEN op .... - Imprima apenas a forma da credencial: campo presente, comprimento, classe do prefixo se útil.
- Escritas ou logs públicos: evite vazar corpos de mensagem a menos que o usuário tenha pedido para ler/verificar SMS.
Roteamento de Credenciais
- Verifique Twilio CLI/profile:
twilio --versionounpx -y twilio-cli --versiontwilio profiles:listounpx -y twilio-cli profiles:list
- Verifique apenas a presença exata de envs:
TWILIO_ACCOUNT_SIDTWILIO_AUTH_TOKEN- opcionais vars de chave/segredo API
- Se apenas env parcial existir, pesquise metadados do 1Password primeiro.
- Prefira um item com campos correspondentes a:
TWILIO_ACCOUNT_SIDTWILIO_AUTH_TOKEN- opcional
TWILIO_FROM_NUMBER
- Se
opsó vir um cofre restrito, tente novamente leituras com suporte desktop usandoenv -u OP_SERVICE_ACCOUNT_TOKEN. - Verifique a autenticação antes de qualquer compra/envio:
curl -sS -u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN" \
"https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID.json"
Configuração CLI
A criação de perfil do Twilio CLI requer o auth token da conta, não apenas credenciais de chave de API:
npx -y twilio-cli profiles:create "$TWILIO_ACCOUNT_SID" \
--auth-token "$TWILIO_AUTH_TOKEN" \
--profile default --force --silent
npx -y twilio-cli profiles:use default
Use npx -y twilio-cli quando twilio não estiver instalado.
Números
Listar os possuídos:
npx -y twilio-cli api:core:incoming-phone-numbers:list \
--properties phoneNumber,friendlyName,capabilities
Pesquisar inventário local de números dos EUA com capacidade SMS:
npx -y twilio-cli api:core:available-phone-numbers:local:list \
--country-code US --sms-enabled --voice-enabled --limit 5
Se a forma do CLI for estranha ou faltarem flags, use REST:
curl -sS -u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN" \
"https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/AvailablePhoneNumbers/US/Local.json?SmsEnabled=true&VoiceEnabled=true&PageSize=5"
Comprar um candidato:
curl -sS -u "$TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN" \
-X POST "https://api.twilio.com/2010-04-01/Accounts/$TWILIO_ACCOUNT_SID/IncomingPhoneNumbers.json" \
--data-urlencode "PhoneNumber=$PHONE_NUMBER"
Verifique propriedade/capacidades após a compra. O JSON do Twilio usa chaves minúsculas:
capabilities.sms
capabilities.mms
capabilities.voice
Marque números que o usuário deseja manter:
npx -y twilio-cli api:core:incoming-phone-numbers:update \
--sid "$PHONE_NUMBER_SID" \
--friendly-name "KEEP - <propósito>"
Regra de retenção: um número é mantido enquanto permanecer na conta Twilio e o faturamento estiver saudável. Não libere/exclua a menos que explicitamente solicitado.
SMS
Enviar:
npx -y twilio-cli api:core:messages:create \
--from "$FROM_NUMBER" \
--to "$TO_NUMBER" \
--body "$BODY" \
-o json
Obter status:
npx -y twilio-cli api:core:messages:fetch --sid "$MESSAGE_SID" -o json
Verificar recebidas de um número:
npx -y twilio-cli api:core:messages:list \
--to "$NUMBER" --limit 20 -o json
Verificar enviadas de um número:
npx -y twilio-cli api:core:messages:list \
--from "$NUMBER" --limit 20 -o json
O JSON do Twilio CLI pode retornar um array para comandos de recurso único. Analise defensivamente:
jq 'if type=="array" then .[0] else . end'
Notas
- SMS internacional pode mostrar um remetente alfanumérico ou da operadora em vez do número comprado nos EUA.
- SMS nos EUA pode estar sujeito a conformidade. Se o envio para destinatários nos EUA falhar, verifique o estado de registro A2P/10DLC antes de tentar novamente cegamente.
- Contas trial podem restringir destinatários.