Atualizar seus tokens de API com segurança
Cada Conta Connect contém credenciais que permitem ao REDA Connect enviar em seu nome: um Token do WhatsApp para a Meta e o par Chave de API SMS / Segredo de API SMS para a Twilio. Esses valores são inseridos de uma única forma: pelas ações Atualizar token de auth. WhatsApp e Atualizar tokens de API SMS do registro de Conta Connect. Nunca digite, cole ou edite um token diretamente em um campo. As ações armazenam os valores criptografados e seus diálogos não exibem novamente as credenciais atuais.
Por que essa regra? Os campos contêm o valor criptografado, não o token em si. A ajuda informa isso expressamente: os campos SMS dizem «Não atualize diretamente. Use o botão 'Update SMS API Tokens' para atualizar o valor.» e o campo do WhatsApp diz «Não atualize o token diretamente no campo. Use o botão Update WhatsApp Auth Token para atualizar o token.» Um token sem criptografia inserido diretamente não tem o formato esperado, e os envios dessa conta falharão até que a ação seja usada corretamente.
- O registro de Conta Connect já deve existir: Criar uma Conta Connect.
- Tenha a nova credencial preparada em um gerenciador de senhas: o token permanente da Meta (de Criar um token de acesso permanente) ou a chave e o segredo da Twilio (de Obter suas credenciais da Twilio).
- Os diálogos de atualização não mostram as credenciais atuais. Mantenha a cópia de referência necessária no gerenciador de senhas ou cofre aprovado.
Resumo das duas ações
| Ação | Canal | O que armazena | Mensagem de sucesso (literal) |
|---|---|---|---|
| Atualizar token de auth. WhatsApp | O token de acesso da Meta em Token do WhatsApp | O token de autenticação do WhatsApp foi atualizado com sucesso. | |
| Atualizar tokens de API SMS | SMS | A chave e o segredo da Twilio em Chave de API SMS e Segredo de API SMS | Tokens da API atualizados com sucesso. |
Atualizar um token
- Abra REDA Connect pelo Iniciador de aplicativos, entre em Contas Connect e abra a conta cuja credencial vai atualizar.
- Clique em Atualizar token de auth. WhatsApp ou Atualizar tokens de API SMS na barra de ações do registro; se não aparecer, abra a seta no final.
- Cole os novos valores no diálogo e confirme. O do WhatsApp se chama Atualizar token de autenticação do WhatsApp e tem o campo obrigatório Token de autenticação do WhatsApp. O de SMS se chama Atualizar tokens da API de SMS e tem os campos obrigatórios Chave da API de SMS e Segredo da API de SMS. Ambos mostram Nome da conta Connect somente leitura e Descrição opcional. Confirme com Token de atualização; o botão Fechar cancela.
- Aguarde o aviso de confirmação:
O token de autenticação do WhatsApp foi atualizado com sucesso.ouTokens da API atualizados com sucesso.
Resultado esperado: o aviso aparece e a credencial salva é substituída. A próxima mensagem da conta usa o novo token; não é preciso reiniciar nem salvar mais nada.
Quando rotacionar um token
Atualize a credencial salva quando:
- A Meta ou a Twilio a rotacionar ou invalidar: por exemplo, se o token da Meta for regenerado ou a chave da Twilio for excluída e recriada.
- Alguém que conhecia a credencial sair da equipe ou um dispositivo que a continha for perdido.
- Houver suspeita de qualquer exposição: colar um token em um chat, chamado ou documento compartilhado conta como exposição. Primeiro gere uma credencial nova no provedor e depois salve-a aqui.
Crie a credencial substituta, atualize a Conta Connect pela ação correspondente e teste-a antes de revogar a anterior quando a política de segurança permitir. Revogar uma credencial ainda em uso interrompe suas chamadas; a rotação não garante ausência de interrupções.
O que acontece quando um token está incorreto
A conta continua tentando enviar mensagens e as falhas ficam visíveis:
- As mensagens enviadas terminam com Status
Falhoue o campo Mensagem de erro registra o que o provedor informou: detalhes da Meta para WhatsApp ou texto da Twilio para SMS. Uma credencial expirada ou digitada incorretamente costuma produzir um erro de autenticação do provedor. - Se faltar uma credencial obrigatória ou a configuração do canal estiver incompleta, Mensagem de erro conterá
Configuração de conta com falha no Connect.: o envio é rejeitado antes de contatar o provedor.
Nos dois casos, salve uma credencial válida pela ação e envie novamente. Para interpretar erros de forma sistemática, veja Uma mensagem não está sendo enviada.
Solução de problemas
| Sintoma | Causa | Correção |
|---|---|---|
A ação mostra Solicitação inválida: tente novamente ou entre em contato com o administrador do sistema. | A ação foi executada sem os dados necessários ou em um registro inadequado | Reabra o registro e execute a ação novamente; se persistir, contate o administrador |
| Os envios falham com erros de autenticação da Meta ou da Twilio em Mensagem de erro | O token salvo expirou, foi revogado ou foi colado incorretamente | Gere uma credencial nova no provedor e execute novamente a ação correspondente |
Os envios falham com Configuração de conta com falha no Connect. | A conta está inativa ou falta um campo obrigatório do canal (endpoint, número ou credencial) | Revise a conta com Criar uma Conta Connect e salve a credencial novamente |
| Alguém escreveu um token diretamente no campo | O valor salvo não tem o formato criptografado esperado pelo sistema | Execute a ação correta com o token real; ela sobrescreve o campo corretamente |
| Aparecem duas versões da ação | O layout mantém ações anteriores à versão 1.93 rotuladas «(Obsoleto)» | Use as atuais e peça a um administrador para remover as obsoletas do layout de Conta Connect |
Perguntas frequentes
Os diálogos de atualização não exibem novamente a credencial armazenada em texto simples. Os valores são armazenados criptografados e descriptografados para autenticação no provedor. Use o cofre aprovado ou gere uma substituição se perdeu o valor; não edite diretamente os campos criptografados.
Não. Cada tentativa falha separadamente com Status Falhou e uma Mensagem de erro. Depois de salvar a credencial correta, as mensagens com falha não são tentadas automaticamente; envie novamente as necessárias.
Não. Execute a ação na conta ativa; o novo valor se aplica imediatamente aos próximos envios.
Atualizar token de auth. WhatsApp preenche Token do WhatsApp. Atualizar tokens de API SMS preenche Chave de API SMS e Segredo de API SMS. Ignore Chave de API SMS [OBSOLETO] e Segredo de API SMS [OBSOLETO] se aparecerem no layout: pertencem a uma versão anterior e não são mais usados.
Próximos passos
- Criar um token de acesso permanente: gere o token da Meta armazenado neste artigo.
- Obter suas credenciais da Twilio: gere a chave e o segredo da Twilio armazenados aqui.
- Uma mensagem não está sendo enviada: interprete os erros da mensagem e tome providências.