Criar a Conta Connect de SMS
Uma Conta Connect é o registro do Salesforce que contém tudo de que o REDA Connect precisa para enviar e receber mensagens por um canal. Para SMS, isso inclui as credenciais da Twilio, o número de telefone, o endereço web que o REDA Connect chama para enviar e o endereço para o qual a Twilio retorna as confirmações de entrega. Este artigo configura o canal SMS campo a campo, incluindo os dois detalhes que causam quase todas as falhas iniciais: a URL do endpoint deve incluir seu próprio Account SID e o número remetente deve conter apenas dígitos.
- Você já reuniu os três valores da Twilio: Obter suas credenciais da Twilio.
- O Site público existe e você conhece seu endereço: Criar o Site público para receber mensagens.
- Você conhece seu número de telefone da Twilio.
- Se você ainda não conhece as Contas Connect, leia primeiro O que é uma Conta Connect? Este artigo serve tanto para uma conta nova quanto para adicionar SMS a uma conta do WhatsApp existente: os campos são os mesmos.
Etapa 1: abra ou crie a Conta Connect
- Abra o Iniciador de aplicativos (a grade de nove pontos, no canto superior esquerdo), procure Contas Connect e abra a guia.
- Clique em Novo ou abra a conta existente à qual deseja adicionar SMS. (Para o guia geral, veja Criar uma Conta Connect).
- Em Canais de mensagens (seleção múltipla obrigatória), mova SMS para a lista selecionada. Se a conta também usa WhatsApp, mantenha WhatsApp selecionado: uma conta pode atender aos dois.
Etapa 2: preencha os campos de SMS
Todos os campos SMS do registro, na ordem em que convém considerá-los. Os rótulos são os da tela; a coluna «O que inserir» indica o que fazer.
| Rótulo do campo | O que inserir |
|---|---|
| Nome da conta Connect | Um nome reconhecível, por exemplo, Acme Rentals SMS. |
| Provedor de SMS | Mantenha Twilio, a única opção e a padrão. Ajuda na tela: «Escolha o provedor de serviço de SMS para esta Connect Account. Observe que a configuração da integração de SMS depende do provedor de serviço de SMS.» |
| Número de remetente SMS | Seu número da Twilio, apenas dígitos, com código do país, sem + nem espaços: etapa 3. |
| ID da conta SMS | Seu Account SID da Twilio (começa com AC). Ajuda na tela: «Informe o SMS Account Id criado no provedor de SMS. Usado para identificar a Connect Account para mensagens recebidas.» |
| Endpoint de API de produção SMS | A URL Messages da Twilio com seu Account SID incluído: etapa 4. |
| URL de callback de status SMS | Endereço do seu Site + caminho fixo, terminando em /: etapa 5. |
| Chave de API SMS | Um valor provisório ao salvar pela primeira vez: etapa 6. Nunca cole a chave real diretamente aqui. |
| Segredo de API SMS | Um valor provisório ao salvar pela primeira vez: etapa 6. Nunca cole o segredo real diretamente aqui. |
| ID do serviço de mensagens SMS | Deixe em branco, a menos que use um serviço de mensagens da Twilio: Usar um serviço de mensagens da Twilio. |
| Descrição da configuração SMS | Notas opcionais para futuros administradores («Chave rotacionada em 2026-08, campanha XYZ registrada»). |
| Ativo | Deixe desmarcado até a etapa 7. Ajuda na tela: «Apenas contas ativas podem ser usadas para enviar e receber mensagens.» |
| Padrão | Marque se esta deve ser a conta de fallback quando não existir uma seleção mais específica: Contas padrão e ordem de seleção. |
Etapa 3: número remetente internacional, apenas dígitos
O REDA Connect compara e disca números em um único formato: código do país + número, apenas dígitos, sem +, espaços, hífens. Remova o prefixo nacional somente quando o formato internacional do país exigir; preserve zeros significativos. Para o número dos EUA (222) 333-4444, insira 12223334444; para um número da Índia, insira 918888888888.
A ajuda do campo diz o mesmo: «Informe o SMS Number para a Connect Account. O número deve ser informado no seguinte formato: <Country ISD Code><Number>. O número não deve conter caracteres especiais nem espaços.»
Um + armazenado impede o envio: o REDA Connect adiciona o + ao se comunicar com a Twilio, portanto +14155550123 sai como ++14155550123 e falha. A mesma regra se aplica a todos os telefones usados pelo REDA Connect, incluindo os de clientes nos seus registros. Veja a explicação completa em Como inserir números de telefone.
Etapa 4: a URL do endpoint inclui SEU Account SID
Endpoint de API de produção SMS é o endereço web que o REDA Connect chama para enviar cada SMS. Na Twilio ele sempre tem este formato, com seu próprio Account SID no meio:
https://api.twilio.com/2010-04-01/Accounts/<your Account SID>/Messages.jsonExemplo prático. Seu Account SID (de Obter suas credenciais da Twilio) é AC0123456789abcdef0123456789abcdef. Então insira:
https://api.twilio.com/2010-04-01/Accounts/AC0123456789abcdef0123456789abcdef/Messages.jsonCole o modelo em um editor de texto e substitua somente <your Account SID>. Mantenha exatamente Accounts/ antes e /Messages.json depois. Um exemplo copiado de outra configuração enviará o SID de outra pessoa e a autenticação falhará; é um dos erros iniciais mais frequentes.
Etapa 5: URL de callback de status (a barra final importa)
URL de callback de status SMS é onde a Twilio retorna à sua organização as confirmações de entrega (Enviado, Entregue e falhas). É o endereço do Site mais um caminho fixo:
https://<your-site-domain>/services/apexrest/rconn/twilio-inbound/Se você criou o Site com um sufixo de caminho (por exemplo, reda), ele vem logo após o domínio:
https://<your-site-domain>/reda/services/apexrest/rconn/twilio-inbound/É o endereço do webhook de SMS da etapa 4 de Criar o Site público para receber mensagens: você também o fornecerá à Twilio no próximo artigo.
Duas regras:
- Um registro novo preenche o campo com
<SITE-URL>/services/apexrest/rconn/twilio-inbound/. O texto literal<SITE-URL>é um marcador que você deve substituir pelo endereço real do Site. - Mantenha o
/final. O REDA Connect estende esse endereço por mensagem ao solicitar confirmações à Twilio. Sem a barra final, as confirmações chegam, mas nunca são reconhecidas, e as mensagens ficam indefinidamente em Na fila ou Enviado.
Etapa 6: primeiro salve com marcadores; depois, os tokens reais
Chave de API SMS e Segredo de API SMS armazenam seus valores criptografados. A criptografia só acontece pela ação específica, nunca ao escrever diretamente nos campos. A ajuda de ambos diz: «Não atualize diretamente. Use o botão "Update SMS API Tokens" para atualizar o valor.»
Porém, o registro não é salvo com esses campos vazios. Por isso, o primeiro salvamento exige duas etapas:
- Insira um valor provisório curto (por exemplo,
TEMP) em Chave de API SMS e Segredo de API SMS e clique em Salvar. - No registro salvo, clique em Atualizar tokens de API SMS entre as ações do registro. Use a que não tem «(Obsoleto)» no nome. Cole o SID da chave de API e o Secret reais de Obter suas credenciais da Twilio e confirme.
Resultado esperado: aparece o aviso Tokens da API atualizados com sucesso. Os campos mostram sequências criptografadas longas; isso está correto e você não verá os valores reais novamente neste registro. Mais informações: Atualizar seus tokens de API com segurança.
Se tentar salvar sem algum valor SMS obrigatório, o registro será bloqueado com esta mensagem exata:
Você deve fornecer valor para os seguintes campos:
Endpoint de API SMS,
Chave de API SMS,
Segredo de API SMS,
Provedor de SMS,
Número de remetente SMS(A primeira linha se refere ao campo da tela Endpoint de API de produção SMS).
Se a conta também tiver WhatsApp em Canais de mensagens e seus campos ainda estiverem incompletos, a validação equivalente bloqueará o salvamento com:
Você deve fornecer valor para os seguintes campos:
Endpoint de API WhatsApp,
Token de autenticação WhatsApp,
Número do WhatsApp,Preencha os campos do WhatsApp (veja Criar a Conta Connect do WhatsApp) ou remova WhatsApp de Canais de mensagens até estar pronto.
Etapa 7: ative a conta
Edite o registro, marque Ativo e salve. Somente contas ativas podem enviar ou receber. Uma conta inativa também não participa da vinculação de mensagens recebidas, portanto as respostas seriam descartadas e um erro ficaria nos logs.
Resultado esperado: a conta aparece na exibição de lista Active Connect Accounts.
Solução de problemas
| Sintoma | Causa | Correção |
|---|---|---|
| Salvamento bloqueado com «Você deve fornecer valor para os seguintes campos: Endpoint de API SMS, …» | Um dos cinco valores SMS obrigatórios está vazio | Preencha; para chave e segredo use um marcador e depois a etapa 6 |
| Salvamento bloqueado com a mensagem de campos do WhatsApp | WhatsApp está selecionado em Canais de mensagens, mas não está configurado | Conclua o WhatsApp ou desmarque o canal por enquanto |
| A primeira mensagem falha com erro de autenticação | Account SID incorreto na URL do endpoint, ou tokens escritos nos campos em vez de usar a ação | Reconstrua a URL (etapa 4) e execute novamente Atualizar tokens de API SMS (etapa 6) |
| As mensagens ficam em Na fila/Enviado e os indicadores não atualizam | Falta o / final em URL de callback de status SMS ou ela ainda contém <SITE-URL> | Insira novamente conforme a etapa 5 |
Perguntas frequentes
Sim: selecione os dois em Canais de mensagens e preencha os dois grupos de campos. Muitas organizações preferem uma conta por canal apenas por clareza; as duas opções funcionam.
As três credenciais: Obter suas credenciais da Twilio. O endereço do Site: Criar o Site público. O número de telefone: console da Twilio em Phone Numbers → Manage → Active numbers.
Os valores escritos diretamente são armazenados como estão, sem criptografia e inutilizáveis: o envio falhará na autenticação. Atualizar tokens de API SMS é a ação que os criptografa e armazena corretamente.
Não. A permissão para sua organização chamar api.twilio.com, uma configuração de site remoto, vem com o pacote.
Uma Conta Connect por número remetente. Use Padrão e a configuração de objetos para direcionar a conta usada por cada equipe ou objeto: Contas padrão e ordem de seleção.
Próximos passos
- Conectar os webhooks da Twilio: informe à Twilio onde entregar os SMS recebidos, a outra metade das mensagens bidirecionais.
- Verificar sua conexão de SMS: teste de ponta a ponta quando o webhook estiver pronto.