Obter suas credenciais da Twilio

O REDA Connect se autentica na Twilio com exatamente três valores: seu Account SID, o SID de uma chave de API e o Secret dessa chave. Este artigo mostra onde encontrar cada valor na console da Twilio, como criar a chave de API (seu Secret é exibido uma única vez, a etapa em que costumam ocorrer erros) e qual campo do REDA Connect recebe cada valor. Reúna os três agora: você os usará no próximo artigo.

Os três valores e seus destinos no REDA Connect

Você inserirá os valores em Criar a Conta Connect de SMS; este artigo explica apenas como reuni-los com segurança.

Etapa 1: copie seu Account SID

O Account SID é o identificador público da sua conta da Twilio. Ele não é secreto, mas o REDA Connect precisa dele em dois lugares; copie-o exatamente.

1. Entre em console.twilio.com.
2. Na página inicial da console, encontre o painel Account Info: ele mostra Account SID, Auth Token e seu número de telefone da Twilio.
3. Clique no ícone de copiar ao lado de Account SID e guarde o valor. Ele sempre começa com AC.

Resultado esperado: você tem um valor de 34 caracteres, começando com AC, salvo nas suas notas.

Seu Account SID (sempre começa com AC) em Admin → Account management → General settings. Copie-o exatamente: ele faz parte do endereço do endpoint da sua Conta Connect.

Etapa 2: crie uma chave de API Standard

Uma chave de API é uma credencial independente que atua em nome da sua conta. Crie uma especificamente para o REDA Connect:

1. Na console da Twilio, acesse Twilio Console → Settings → API keys & tokens.
2. Clique em Create API key.
3. Preencha o formulário:
   • Friendly name: um nome que você reconheça depois, por exemplo, REDA Connect SMS.
   • Key type: Standard. (Uma chave Standard pode enviar e receber mensagens, mas não gerenciar sua conta nem outras chaves: exatamente o acesso de que o REDA Connect precisa. Não escolha Restricted nem Main.)
4. Clique em Create / Next.

Resultado esperado: a Twilio mostra o SID da nova chave (começa com SK) e seu Secret: esta é a única vez em que o Secret é exibido.

1. Copie os dois valores para suas notas seguras agora. A Twilio exige marcar a opção Got it! para confirmar que você guardou o Secret antes de clicar em Finish.

Keys & Credentials → API keys & tokens: clique em Create API key e mantenha o tipo Standard. O SID da chave continua visível depois, mas o Secret é exibido apenas uma vez, na criação: copie-o imediatamente.

Por que uma chave de API em vez do Auth Token?

Tecnicamente, a Twilio aceita Account SID + Auth Token ou SID de chave de API + Secret para enviar mensagens, e os campos de credenciais do REDA Connect podem conter qualquer um dos pares. Use a chave de API:

• Rotação independente. Uma chave API dedicada pode ser substituída sem alterar o Auth Token. Crie, atualize e teste a substituição antes de revogar a chave anterior quando apropriado; excluir uma chave em uso causa falhas.
• Acesso limitado. Uma chave Standard não pode alterar as configurações da conta nem criar outras chaves; o Auth Token tem acesso completo.
• Auditável. Uma chave chamada REDA Connect SMS identifica sua finalidade. O uso do Auth Token é anônimo.

Regras para proteger as credenciais

• Guarde os três valores em um gerenciador de senhas, não em e-mails, chats ou planilhas compartilhadas.
• O Secret é o valor sensível: trate-o como uma senha.
• Depois de inseridos no REDA Connect, a chave e o segredo são armazenados criptografados e só podem ser alterados por Atualizar tokens de API SMS. Você não poderá lê-los novamente no Salesforce; a cópia do gerenciador de senhas é a referência.
• Nunca cole esses valores em um chamado de suporte nem os mostre em uma captura. Quando o suporte da REDA precisa ver sua configuração, precisa dos nomes dos campos, não dos valores.

Perguntas frequentes

Próximos passos

• Criar a Conta Connect de SMS: insira os três valores no REDA Connect, campo a campo.
• Atualizar seus tokens de API com segurança: como as credenciais são armazenadas no REDA Connect e como rotacioná-las depois.