Integre o airfocus com o Salesforce.

Benefícios de usar a integração com o Salesforce

Nossa integração com o Salesforce permite agrupar feedbacks diretamente de seus casos e oportunidades no Salesforce. Importe e centralize facilmente dados do Salesforce para o airfocus e embase a descoberta de produtos.

• Importe facilmente casos e oportunidades do Salesforce como itens para o airfocus para gerar insights para descoberta e priorização de produtos.
• Capacidade de mapear de forma flexível diversos campos do sistema Salesforce para campos do airfocus.

Requisitos

Para poder utilizar a integração com o Salesforce, o usuário precisa garantir que atende aos seguintes requisitos:

No airfocus

• o usuário precisa ter permissões de acesso “total” ao espaço de trabalho.
• A equipe airfocus precisa estar inscrita no plano “Corporativo”.

Na Salesforce

O usuário utilizado para configurar a integração precisa ser atribuído a um perfil que tenha as seguintes características:

• Conceda pelo menos permissões de leitura para todos os objetos/informações que devem ser sincronizados por meio da integração.
• As configurações “API ativada” e “Gerenciar aplicativos conectados” foram ativadas. Os administradores de sistema podem verificar isso para qualquer um dos perfis configurados em Configuração > Configuração de administração > Gerenciar usuário > Perfis.
• Por padrão, ao criar um aplicativo no Salesforce, a opção "Exigir extensão de chave de prova para troca de código (PKCE) para fluxo de autorização compatível" está habilitada. Esta opção precisa ser desativada.

Informações adicionais para sincronização de "casos":

• A organização Salesforce precisa ter uma assinatura do Salesforce Service Cloud e acesso à "API de Serviços Web", que atualmente está disponível nas edições "Professional" (com custo adicional), "Corporativo" e "Unlimited".
  

Informações adicionais para sincronização de “oportunidades”:

• A organização Salesforce precisa ser assinante do Salesforce Sales Cloud e ter acesso à "API de Serviços Web", que atualmente está disponível nas edições "Professional" (com custo adicional), "Corporativo" e "Unlimited".
  

Configurando a integração

Configurar a integração é fácil e deve levar apenas alguns minutos. Eis como fazer:

Faça login no airfocus.

Primeiro, inscreva-se no airfocus ou faça login na sua conta existente. Crie um novo espaço de trabalho no airfocus ou selecione aquele com o qual você gostaria de integrar o Salesforce.

Adicione uma integração com o Salesforce ao airfocus.

Tenha em mente que uma integração sempre se conecta a um espaço de trabalho específico. Você pode adicionar várias integrações do Salesforce a um determinado espaço de trabalho.

Para configurar a integração, acesse "Gerenciar integração" em suas extensões e conecte-se ao Salesforce.

Na tela seguinte, você precisa selecionar "Conectar uma nova instância do Salesforce" no menu suspenso. Se você já se conectou a instâncias do Salesforce em sua Equipe anteriormente, todas as instâncias disponíveis do Salesforce serão exibidas neste menu suspenso. Você pode criar quantas integrações do Salesforce desejar para uma única instância do Salesforce.

Em seguida, você precisa dar um nome à sua nova conexão com a instância do Salesforce (que será exibido posteriormente no airfocus). Abaixo, você pode inserir a chave do consumidor (ID do cliente) e o segredo do consumidor (segredo do cliente) do seu aplicativo conectado ao Salesforce para poder se conectar ao Salesforce.

Configure um aplicativo conectado no Salesforce.

1. Faça login na sua organização do Salesforce.
2. Abra a página de configurações dos aplicativos conectados:
   • Se você estiver usando o Salesforce Classic, acesse Configuração > Configuração de aplicativos > Criar > Aplicativos.
     
   • Se você estiver usando o Salesforce Lightning, acesse Configuração > Ferramentas da plataforma > Aplicativos > Gerenciador de aplicativos.
     
     
3. Criar um novo aplicativo conectado:
   • Se você estiver usando o Salesforce Classic : na seção Aplicativos conectados, clique em “Novo”.
     
   • Se você estiver usando o Salesforce Lightning : ao lado de "Gerenciador de Aplicativos do Lightning Experience", clique em "Novo Aplicativo Conectado".
     
4. Preencha a seção de informações básicas:
   • Nome do aplicativo conectado: por exemplo, “airfocus”.
   • Nome da API: por exemplo, “airfocus”.
   • E-mail para contato: seu endereço de e-mail.
     
5. Na seção API (Ativar configurações OAuth):
   • Marque a caixa para “Ativar as configurações OAuth ”.
   • Dependendo do seu servidor airfocus (veja a nota abaixo), copie este URL de retorno de chamada:
     • Servidor europeu : https://app.airfocus.com/api/integration-providers/salesforce/callback e cole-o no campo "URL de retorno de chamada".
     • Servidor dos EUA: https://app.airfocus.com/api/integration-providers/salesforce/callback e cole-o no campo "URL de retorno de chamada".
     • Novo servidor dos EUA (se você estiver localizado nos EUA ou na região da Ásia-Pacífico e sua conta foi criada após setembro de 2025): https://app.airfocus.app/api/integration-providers/salesforce/callback e cole-o no campo "URL de retorno de chamada".
   • Em Escopos OAuth Selecionados, adicione os seguintes escopos:
     • Gerencie dados do usuário por meio de APIs (api).
     • Realizar solicitações a qualquer momento (refresh_token, offline_access).
       
     • Nota: para encontrar a localização do seu servidor airfocus, verifique o URL do airfocus. Se ele contiver "us.airfocus", está nos EUA; caso contrário, está na Europa. Por exemplo: teamname.us.airfocus.com em vez de teamname.airfocus.com
     • Atenção: se você estiver localizado nos EUA ou na região da Ásia-Pacífico e sua conta tiver sido criada após setembro de 2025, o URL será teamname.airfocus.app.
6. Clique em “Salvar”. A próxima tela informará que você poderá ter que esperar até 10 minutos para que as alterações sejam aplicadas. Clique em "Continuar". Aguarde 10 minutos.
   

Observação: você será redirecionado para a página de gerenciamento do seu aplicativo conectado, para que possa continuar diretamente com o passo 4 na próxima seção deste guia.

Conecte o airfocus ao Salesforce

1. Faça login na sua organização do Salesforce.
2. Abra a página de configurações dos aplicativos conectados:
   • Se você estiver usando o Salesforce Classic, acesse Configuração > Configuração de aplicativos > Criar > Aplicativos.
     
   • Se você estiver usando o Salesforce Lightning, acesse Configuração > Ferramentas da plataforma > Aplicativos > Gerenciador de aplicativos.
     
3. Abra a visão geral do seu aplicativo conectado:
   • Se você estiver usando o Salesforce Classic, na seção "Aplicativos Conectados", clique no nome do seu aplicativo conectado para o airfocus.
     
   • Se você estiver no Salesforce Lightning, nas tabelas, clique na seta suspensa do seu aplicativo e clique em "visualizações".
     
4. Na seção “API (Ativar configurações OAuth)”, clique em “Gerenciar detalhes do consumidor”.
   
5. Você poderá ter que verificar sua identidade com a Salesforce.
6. Copie a “Chave do Consumidor” e o “Segredo do Consumidor” e cole-os nos campos correspondentes na configuração de integração do airfocus com o Salesforce.
   
   
7. Clique em “Conectar” no airfocus.
8. Você será redirecionado para uma tela de confirmação do Salesforce. Clique em "Permitir".
   

Configure sua integração

Você pode nomear a integração inserindo um nome no campo "Nome" localizado na parte superior da página de configurações de integração do Salesforce. Esse nome também será exibido na visão geral da integração e na janela pop-up de extensões para facilitar a identificação.

Filtros

Selecione o tipo de objeto do Salesforce que você deseja importar/sincronizar com o airfocus. A integração atualmente oferece suporte a casos e oportunidades do Salesforce. Se você deseja sincronizar ambos os tipos de objeto, precisa configurar uma integração para cada um deles (ambos podem se conectar por meio da mesma instância do Salesforce, portanto, você não precisa criar um aplicativo conectado para cada tipo de objeto).

Selecione uma data através do seletor de datas no campo "Importar objetos criados após" para importar apenas os objetos que foram criados após a data selecionada. Se você não especificar uma data aqui, a integração importará todos os objetos do Salesforce do tipo selecionado.

Você pode refinar ainda mais a seleção dos objetos que devem ser sincronizados inserindo uma condição WHERE para a Linguagem de Consulta de Objetos do Salesforce (SOQL). Combine múltiplas condições com AND ou OR. Se você selecionar uma data de Início no campo acima, ela será adicionada implicitamente à cláusula WHERE. Todos os campos aqui mencionados devem ter um mapeamento definido na seção "Mapeamento de campos" abaixo. Saber mais.

Mapeamento de campo

Utilize o mapeamento para definir como as informações do Salesforce devem ser mapeadas para o airfocus. Os nomes e descrições dos itens são sempre mapeados por padrão ao configurar uma nova integração e podem ser removidos ou modificados opcionalmente.

Como adicionar um novo mapeamento de campo

Ao selecionar um campo na lista suspensa, somente os campos que corresponderem ao tipo de campo serão exibidos na lista suspensa do airfocus. Nossa integração permite mapear campos do tipo de objeto principal (selecionado acima), bem como campos de objetos diretamente conectados.

No exemplo abaixo, o usuário selecionou "Caso" como o tipo de objeto do Salesforce a ser importado/sincronizado. O campo "Prioridade" (marcado em vermelho) é um campo do sistema do objeto "Caso". O campo "ID do Caso" (marcado em verde) é um campo de sistema do objeto "MasterRecord", que é um objeto diretamente conectado ao "Caso".

Simplificando: se um campo estiver a, no máximo, um clique de distância do seu objeto sincronizado no Salesforce, você poderá mapeá-lo para o seu item no airfocus (as condições descritas neste artigo se aplicam).

Atualmente, a integração permite sincronizar informações apenas de forma unidirecional, do Salesforce para o airfocus.

Após selecionar os dois campos que deseja mapear, você pode escolher as opções de campo e como eles devem ser mapeados. Você também pode mapear várias opções de campo do Salesforce para uma única opção de campo do airfocus.

Tipos de campos disponíveis para mapeamento

Atualmente, a integração permite sincronizar campos do sistema apenas de forma unidirecional, do Salesforce para o airfocus. Segue abaixo uma lista dos possíveis mapeamentos de campos que você pode configurar:

Como determinar o tipo de campo dos seus campos do Salesforce

Você pode encontrar uma lista de todos os campos disponíveis/configurados no seu tipo de objeto do Salesforce (como “Caso” ou “Oportunidade”) nas suas configurações do Salesforce:

1. Faça login na organização do Salesforce à qual você está se conectando ao airfocus.
2. No seu painel principal do Salesforce, clique no ícone de engrenagem de configurações ao lado do seu avatar de perfil e clique em “Configurar”.
   
3. Na barra lateral de configuração, clique em Ferramentas da Plataforma > Objetos e Campos > “Gerenciador de Objetos”.
   
4. Procure o tipo de objeto para o qual deseja visualizar os tipos de campo e clique no rótulo do objeto.
   
5. Na barra lateral do tipo de objeto (exemplo: “Caso”), clique em “Campos e relação” e revise a coluna “Tipo de dados” das tabelas para determinar o tipo de campo de qualquer campo que você tenha configurado para esse tipo de objeto.
   
6. Você pode determinar se um campo é personalizado ou do sistema consultando a coluna “Nome do Campo” da tabela. Se o nome de um campo terminar com “__c”, trata-se de um campo personalizado.
   

Outras configurações

Quando a opção "Arquivar itens desconhecidos" está ativada, os itens importados anteriormente serão arquivados no airfocus se não estiverem mais presentes no Salesforce ou se não se enquadrarem mais nos filtros definidos para a integração.

Quando a opção "Sincronização automática" estiver ativada, sua integração será sincronizada automaticamente a cada 10 minutos e sempre que você acessar o espaço de trabalho.

Ao clicar em "visualizações logs", você pode visualizar seus logs de atividades de integração do Salesforce e ver quais alterações foram feitas antes da última sincronização.

Para salvar suas configurações e importar seus itens para o airfocus, clique em "Atualizar e sincronizar".

Notas importantes

A conta de usuário do Salesforce usada para configurar a integração não precisa necessariamente ser usada para utilizar a integração. Contanto que o usuário do airfocus possua chaves e segredos de consumidor válidos, ele poderá configurar quantas integrações com o Salesforce conectado desejar.

A integração está atualmente limitada à sincronização de no máximo. 2000 objetos do Salesforce.

Seu aplicativo conectado é considerado um "Aplicativo Não-SDFC" pela Salesforce. Leia o Contrato de Serviço Principal da Salesforce para consultar as políticas da empresa sobre o uso de aplicativos que não sejam do Salesforce (Non-SDFC) e o uso desses aplicativos para serviços de integração.

Dar feedback sobre este artigo