Integração do CRM Salesforce

Introdução

A 3CX oferece integração com Salesforce por meio da API 3CX para CRM com os seguintes recursos:

• ID do Autor da Chamada para o Nome do contato - as chamadas recebidas acionam uma pesquisa de contato do Salesforce.
• Pesquisa de contatos no Salesforce com base em Nome, Número ou E-mail se você pesquisar um nome no cliente Web 3CX
• Registro de Chamadas e Chats - as chamadas e os chats são registrados no cartão de contato da Salesforce como registros de chamadas de CRM.
• Crie um novo contato do Salesforce a partir do cliente 3CX para chamadas de novos números.
• Click to Call – inicie chamadas diretamente do Salesforce via 3CX, usando as extensões de navegador 3CX Click2Call para Google Chrome e Microsoft Edge.

Requisitos:

• Sua conta do Salesforce deve ter a API REST ativada. Verifique aqui para ver as edições do Salesforce nas quais a API está disponível.
• Contas Salesforce com Contas Pessoais habilitadas não são suportadas.

Passo 1: Configure o Salesforce

1. Faça login em sua conta do Salesforce https://login.salesforce.com/ ou crie uma conta de desenvolvedor a partir daqui https://www.salesforce.com/products/free-trial/developer/.
2. Clique no "Ícone de engrenagem" > "Setup".
3. Na barra lateral, na seção FERRAMENTAS DA PLATAFORMA, selecione "Apps > App Manager".
4. Clique no botão "Novo App de Cliente Externo" no canto superior direito da página da Web.
5. O formulário “Gerenciador de Apps de Clientes Externos” será exibido.

6. No painel Basic Information (Informações Básicas), forneça um nome de App de Cliente Externo, um e-mail de contato e um Estado de Distribuição.

7. Role para baixo até API (Enable OAuth Settings) e marque a caixa de seleção “Enable OAuth”.
8. No campo Callback URL (URL de retorno de chamada), insira o URL usado para acessar o console de admin 3CX, adicionando "/api/oauth2crm" no final, por exemplo: "https://my-pbx.example.com/api/oauth2crm". Em seguida, conceda as permissões conforme a imagem acima. As permissões são:

• Acessar o serviço de URL de identidade (id, perfil, e-mail, endereço, telefone)
• Acessar identificadores exclusivos de usuário (openid)
• Acesso Total (full)
• Gerenciar dados de usuário por meio de APIs (api)
• Gerenciar dados de usuário por meio de navegadores da Web (web)
• Realizar solicitações a qualquer momento (refresh_token, offline_access)

9. Role para baixo até a seção Security (Segurança). Verifique se as opções “Require Secret for Refresh Token Flow” e "Require Secret for Refresh Token Flow" foram selecionadas.
10. Além disso, observe que o PKCE (Proof Key for Code Exchange) agora é compatível com o 3CX Versão 20, Update 6. Você pode usar o fluxo de autenticação PKCE ativando a opção “Require Proof Key for Code Exchange (PKCE) Extension for Supported Authorization Flows”.  Se a opção estiver desativada, o PKCE será ignorado e a autorização será feita com êxito.
11. Pressione Criar.
12. Clique em “Apps > External Client App Manager > Find your app” na lista e clique em “Edit Policies”.

13. Em Policies (Políticas), vá para a seção OAuth policies (Políticas OAuth) e defina Permitted users (Usuários permitidos) como “All users can self-authorize” (Todos os usuários podem se autorizar).
14. Clique em Save (Salvar).

15. Em Settings (Configurações), vá para a seção OAuth Settings (Configurações do OAuth) e clique no botão “Consumer Key and Secret” (Chave e segredo do consumidor). Em seguida, copie os valores de “Consumer Key” (Chave do consumidor) e “Consumer Secret” (Segredo do consumidor) - precisaremos adicioná-los posteriormente na seção de integração do 3CX CRM.

Passo 2: Configurar o 3CX

1. No Console do Admin 3CX, vá para “Integrações” > “CRM”.
2. Selecione "SalesforceV2" na lista suspensa.
3. Preencha os detalhes que você obteve na etapa anterior para a Consumer Key (Chave do Consumidor) e o Consumer Secret (Segredo do Consumidor) e pressione o botão “Save” (Salvar) e, em seguida, o botão “Authorize” (Autorizar) para iniciar o processo de autorização. Conceda acesso ao 3CX, e o Refresh Token (Token de Atualização) será exibido no botão Authorize (Autorizar).

Passo 3: Configurar Registro de Chamada e Chat

1. Para relatar chamadas e chats externos ao Salesforce, o endereço de e-mail configurado para o ramal 3CX deve corresponder ao endereço de e-mail de um usuário do Salesforce. Dessa forma, o 3CX pode mapear o ramal da 3CX que recebe a chamada ou o chat para o usuário do Salesforce.
2. Marque a opção "Ativar Registro de Chamadas” para relatar chamadas externas ao CRM e configure esses parâmetros de "Registro de Chamadas”:

• "Assunto da Chamada" - o assunto da chamada.
• "Chamada de Recebida Atendida" - descrição das chamadas recebidas e atendidas.
• "Chamada Perdida" - descrição das chamadas perdidas.
• "Chamada Realizada Atendida” - descrição das chamadas realizadas e atendidas.
• "Chamada Realizada Não Atendida" - descrição das chamadas realizadas e não atendidas.

3. Observe que você pode usar variáveis nos parâmetros de "Registro de Chamadas", indicadas como
   [variable_name]
   , por exemplo, o número externo é especificado como
   [Number]
   . As variáveis disponíveis para uso estão listadas aqui.

4. Se quiser relatar os chats ao CRM, marque a caixa de seleção Ativar Registro no Diário de Chats e configure os parâmetros abaixo:

• Assunto do chat: O assunto da sessão do chat.

5. Observe que você pode usar variáveis nos parâmetros do "Registro do Chat", indicadas como
   [variable_name]
   , por exemplo, o número externo é especificado como
   [Number]
   . As variáveis disponíveis para uso estão listadas aqui.

Passo 4: Configurar Contatos e164 e ID do Autor da Chamada

1. Para obter uma correspondência com o Salesforce, os últimos 7 dígitos do ID do Chamador de entrada devem corresponder aos últimos 7 dígitos de um campo de telefone em uma entrada do CRM, ou o número completo recebido do Tronco SIP deve corresponder totalmente ao número de telefone no CRM.
2. O Salesforce pode armazenar os números no formato E164, portanto, se o seu Tronco SIP também fornecer o número do chamador no formato E164, é preferível uma correspondência exata. Você também poderá usar a Reformatação do ID do Autor da Chamada para ajustar o número do chamador antes de ser passado para o CRM.
3. ⚠ Importante: No Console do Admin 3CX, abra "Sistema" > "Lista Telefônica" > "Opções". Defina a estratégia de correspondência como "Corresponder exatamente” quando possível (formato E164 exigido no Salesforce e no Tronco SIP) ou "Corresponder pelo menos X caracteres” e defina o valor como 7.
4. ⚠ Importante:  No Salesforce, certifique-se de que todos os números dos seus contatos estejam armazenados no formato E164, incluindo o prefixo mais (+). Esse prefixo mais (+) impede que o Salesforce reformate automaticamente o número se você estiver localizado nos EUA ou no Canadá, o que faz com que a pesquisa de contatos falhe.

Passo 5: Configurar Criação de Contato

1. Se quiser criar novos contatos no CRM quando uma chamada for recebida de um número desconhecido (não encontrado no 3CX e no CRM), marque a caixa de seleção "Permita a criação de contatos diretamente no seu CRM usando o Cliente Web 3CX" e configure os parâmetros abaixo.
2. Os parâmetros de Criação de Contatos são:

• Criar Lead ou Contato - A entidade a ser criada (Lead/Contato).
• Empresa do Novo lead - O nome da empresa quando um lead é criado.

3. Observe que você pode usar variáveis nos parâmetros. As variáveis são especificadas entre [], por exemplo, o número externo é especificado como [Número]. As variáveis disponíveis para uso estão listadas aqui.
4. Quando o número do autor da chamada não puder ser associado a um contato, o cliente 3CX permitirá que o usuário crie o contato preenchendo os detalhes em uma caixa de diálogo.

📄 Observação: ao criar contatos no Salesforce, o nome da empresa especificado no Cliente Web será ignorado. Isso se deve às limitações da API do Salesforce. Isso se aplica apenas a contatos, o nome da empresa é definido ao criar leads.

Veja também

• Veja como integrar seu CRM com a API do 3CX.
• Saiba como configurar a integração Bitrix24.
• Saiba como configurar a integração ConnectWise.
• Saiba como configurar a Integração Microsoft 365.
• Saiba como configurar a integração Zendesk.
• Saiba como configurar a integração Zoho.
• Saiba como configurar integrações de bancos de dados do Microsoft SQL Server, MySQL e PostgreSQL.

Última atualização

Este documento foi atualizado pela última vez em 16 de julho de 2025

https://www.3cx.com.br/docs/integracao-crm-salesforce/