Configurar e configurar seu próprio aplicativo OAuth para Traga seu próprio canal

Alguns parceiros de mensagens e provedores de CCaaS exigem que você configure e gerencie seu próprio aplicativo cliente externo (ECA) ou aplicativo conectado para fornecer autenticação para a integração entre a plataforma e a API do Serviço de interações do Salesforce. Verifique com seu provedor se configurar seu próprio aplicativo é uma etapa de configuração obrigatória para a integração Traga seu próprio canal para Messaging ou Traga seu próprio canal para CCaaS. Primeiro, crie a ECA ou o aplicativo conectado e edite políticas para ela e, em seguida, atualize a Definição do canal de conversa (CCD).

Edições obrigatórias

Exibir edições com suporte.
Este artigo se aplica a:	Traga seu próprio canal para mensagens e Traga seu próprio canal para CCaaS
Este artigo não se aplica a:	Canais do Chat no aplicativo aprimorado, Chat da Web v1 aprimorado, Chat da Web v2 aprimorado, WhatsApp aprimorado, Facebook Messenger padrão e aprimorado, SMS padrão e aprimorado, Apple Messages for Business aprimorado e LINE aprimorado

Permissões necessárias ao usuário
Para criar aplicativos cliente externos locais:	Criar, editar e excluir aplicativos cliente externos
Para ler, criar, atualizar ou excluir aplicativos conectados:	Personalizar aplicativo E Modificar todos os dados OU Gerenciar aplicativos conectados
Para atualizar todos os campos, com exceção de Perfis, Conjuntos de permissões e Atributos de SAML do provedor de serviços:	Personalizar aplicativo E Modificar todos os dados OU Gerenciar aplicativos conectados
Para atualizar Perfis, Conjuntos de permissões e Atributos de SAML do provedor de serviços:	Personalizar aplicativo E Modificar todos os dados E Gerenciar perfis e Conjuntos de permissões

Dica

• Para verificar se seu provedor de mensagens ou CCaaS exige que você configure seu próprio aplicativo cliente externo ou aplicativo conectado, em Configuração, acesse Configurações de mensagens e selecione o canal de mensagens Traga seu próprio canal que você criou. Na seção Definição do canal de conversa, se você vir Modificar definição do canal de conversa, crie seu próprio ECA ou aplicativo conectado. Caso contrário, o provedor parceiro gerencia o aplicativo para você.
• Recomendamos usar um aplicativo cliente externo para autenticação do Serviço de interação em vez de um aplicativo conectado. A partir da versão Spring '26, os clientes não poderão criar um aplicativo conectado a menos que solicitem a capacidade de criar aplicativos conectados do Suporte do Salesforce. Para migrar um aplicativo conectado preexistente, consulte Criar um aplicativo cliente externo a partir de um aplicativo conectado.

Criar um aplicativo cliente externo para OAuth

No Salesforce, configure um aplicativo cliente externo (ECA) para fornecer autenticação para a integração entre a plataforma do provedor de mensagens ou CCaaS e a API do serviço de interações do Salesforce.

1. Se você não tiver um certificado autoassinado, siga as etapas para Criar uma chave privada e um certificado digital autoassinado. Certifique-se de que o certificado esteja salvo no seu sistema. Você carrega o arquivo ao criar o ECA.
2. Crie um aplicativo cliente externo e defina o Estado de distribuição definido como Local.
3. Na área de Configurações de OAuth da página, selecione Habilitar configurações de OAuth.
   A área Configurações do OAuth se expande e os campos de configurações do OAuth ficam visíveis.
4. Adicione um URL de retorno (ponto de extremidade), que é o mesmo URI de redirecionamento do OAuth. Recomendamos usar https://login.salesforce.com para começar.
5. Adicione os escopos OAuth Acessar recursos da API de interação (interaction_api) e Executar solicitações a qualquer momento (refresh_token, offline_access).
6. Na seção Habilitação de fluxo, selecione Habilitar fluxo de portador JWT.
7. Carregue seu certificado autoassinado.
8. Para criar o ECA, clique em Criar.
9. Na guia Políticas do seu aplicativo cliente externo, clique em Editar.
10. Em Políticas do OAuth, na lista suspensa Usuários permitidos, selecione Usuários aprovados pelo administrador estão pré-autorizados. Se você vir uma mensagem de aviso, clique em OK.
11. Em Políticas do aplicativo, adicione o perfil de Administrador do sistema.
12. Salve suas alterações.

Criar um aplicativo conectado para OAuth

Da versão Spring '26 em diante, recomendamos criar um aplicativo cliente externo para fornecer autenticação para a integração entre a plataforma do provedor do parceiro e o Salesforce, em vez de criar um aplicativo conectado.

Se você optar por criar um aplicativo conectado, antes de começar, entre em contato com o Suporte da Salesforce para solicitar a capacidade de criar aplicativos conectados.

1. Se você não tiver um certificado autoassinado, siga as etapas para Criar uma chave privada e um certificado digital autoassinado. Certifique-se de que o certificado esteja salvo no seu sistema. Você faz o upload do arquivo ao criar o aplicativo conectado.
2. Em Configuração, insira Aplicativo cliente externo na caixa Busca rápida e selecione Configurações.
3. Em Aplicativos conectados, clique em Novo aplicativo conectado.
4. No campo Nome do aplicativo conectado, insira um nome exclusivo para o aplicativo conectado. O nome inserido aparece automaticamente no campo Nome da API. Não altere o nome da API.
5. No campo Email de contato, insira o endereço de email da pessoa com a qual a Salesforce deve entrar em contato, se necessário.
6. Marque a caixa de seleção Habilitar configurações do OAuth e defina estas configurações:
   1. Adicione um URL de retorno (ponto de extremidade), que é o mesmo URI de redirecionamento do OAuth. Recomendamos que você use https://login.salesforce.com para começar.
   2. Selecione Usar assinaturas digitais, clique em Escolher arquivo e selecione o arquivo de chave pública no seu sistema para carregá-lo.
   3. Adicione os escopos do OAuth: Acessar recursos da API de interação (interaction_api) e Realizar solicitações a qualquer momento (refresh_token, offline_access)
7. Salve suas alterações e clique em Continuar.

Gerenciar o acesso ao seu aplicativo conectado para OAuth

Se você tiver criado um aplicativo conectado, configure o acesso a ele.

1. Em Configuração, insira Gerenciar aplicativos conectados na caixa Busca rápida e selecione Gerenciar os aplicativos conectados.
2. Clique no nome do aplicativo conectado que você criou.
3. Para abrir a página Edição do aplicativo conectado, clique em Editar políticas.
4. Na seção Políticas do OAuth, defina Usuários permitidos como Os usuários aprovados pelo administrador estão pré-autorizados. Se você vir uma mensagem de aviso, clique em OK.
5. Salve suas alterações.
6. Para abrir a página Atribuição de perfil de aplicativo, clique em Gerenciar perfis.
7. Selecione Administrador de sistema.
8. Salve suas alterações.

Atualize a definição do canal de conversa com seu aplicativo cliente externo ou aplicativo conectado

Depois de configurar seu ECA ou aplicativo conectado, atualize a Definição do canal de conversa para seu canal de mensagens para fazer referência ao aplicativo que você criou.

1. Em Configuração, na caixa Busca rápida, insira Configurações de mensagens e selecione Configurações de mensagens.
2. Selecione o canal de mensagens que você criou.
3. Na seção Definição do canal de conversa, clique em Gerenciar definição do canal de conversa. Se esse botão não estiver disponível, seu provedor CCaaS gerenciará o aplicativo conectado e você não precisará criar um e associá-lo à Definição do canal de conversa.
4. Selecione o aplicativo cliente externo ou o aplicativo conectado que você criou.
5. Salve suas alterações.

Consulte também:

• Aplicativos cliente externos
• Definir as configurações do OAuth do aplicativo cliente externo
• Criar um aplicativo cliente externo a partir de um aplicativo conectado
• Definir as configurações básicas do aplicativo conectado
• Habilitar configurações de OAuth para integração à API