> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.elephan.ai/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Como integrar com o 3CX?

A integração com o 3CX permite automatizar a captura e análise das suas chamadas telefônicas dentro da Elephan. Com essa conexão, todas as ligações realizadas são enviadas automaticamente para a plataforma, onde são transcritas, analisadas e organizadas sem necessidade de processos manuais.

Isso garante mais agilidade, organização e confiabilidade no acompanhamento das suas interações.

## 1. Acesse a Plataforma Elephan

* No menu lateral esquerdo, acesse o campo de **Configurações** e clique em **Integrações - Voip** para visualizar todas as conexões disponíveis.

[![](https://storage.crisp.chat/users/helpdesk/website/-/1/0/a/c/10ac96718a7e6800/79ba742e-4dae-45bf-8f40-2ca003_c0h07m.png)](https://downloads.intercomcdn.com/i/o/y556j3ga/2674890197/ce7eb1d4c7c5394c2024991ea7af/image.png?expires=1791376200&signature=ee01d41afad42ce13429994251f3154549e993d3524935872e993838ec7836c7&req=diYgEsF3nYBWXvMW1HO4zY162Pdz1WOIzxxPycvwvYv19AqAsIjVl03uY3Jf%0Am1InFiBZPikLPMF83lM%3D%0A)

## 2. Conectar com o 3CX

* Localize o **3CX** dentro da lista de integrações disponíveis.
* Clique em **Conectar** para iniciar o processo de integração.

[![](https://storage.crisp.chat/users/helpdesk/website/-/4/3/1/a/431adcd8c825c000/e1a38351-852d-407e-ba6f-a5b232_3v0lq2.png)](https://downloads.intercomcdn.com/i/o/y556j3ga/2674889229/0cefe4d825711bdc5cc6fdc93f17/image.png?expires=1791376200&signature=379de8c9230341418b028d7f751e757ad2db0c41ff0f49d78878fab8910596a4&req=diYgEsF2lINdUPMW1HO4zUdfMv6%2B7jwOH2QHvLOP830r9IIpdrWJttqci4%2BJ%0AA1%2Bk5Q8xjUiPj%2B%2Bqy%2B4%3D%0A)

## 3. Adicione as credenciais de API

Após clicar em **Conectar**, será aberto um menu lateral com as configurações necessárias para ativar a integração.

Preencha os seguintes campos:

* **Client ID**: insira o Client ID da aplicação cadastrada no console do seu servidor 3CX.
* **API Key**: insira a API Key (campo Client Secret) da mesma aplicação.

[![](https://storage.crisp.chat/users/helpdesk/website/-/b/5/0/b/b50b0abf26af0800/4d448aa1-4679-4420-9b35-3a9ca3_9wzg3g.png)](https://downloads.intercomcdn.com/i/o/y556j3ga/2674909560/7227a8cdaee74e51fec230389fe7/image.png?expires=1791376200&signature=5476d9d983b4111479c88e9c9f3ce57678a80859c06e56ce3adafa9b65b7b829&req=diYgEsB%2BlIRZWfMW1HO4zUHWJVZ9PAuPv7RYVqGUq1yL5b8VFdrO%2Buq8QbCn%0AcyLZnuCim%2Fec4e3hUcc%3D%0A)

## Como obter as credenciais de API?

Para gerar suas credenciais no 3CX:

* Acesse o **console de administração** do seu 3CX com um usuário administrador.
* Vá até **Integrações > API** e clique em **Adicionar**.
* Defina um **Client ID** (ex: `elephan`) e habilite o acesso à **API de Configuração do 3CX** (3CX Configuration API Access).
* Selecione o departamento e uma função com permissão de administrador, para que a Elephan consiga ler as gravações das chamadas.
* Clique em **Salvar** e copie a **API Key** (Client Secret) exibida. Ela aparece **apenas uma vez**, então guarde-a em local seguro.

**Pré-requisitos:** sua licença do 3CX precisa permitir o acesso à API, e a **gravação de chamadas** deve estar ativada nos ramais que serão analisados.

Caso tenha dúvidas, recomendamos entrar em contato com o suporte ou com o parceiro responsável pelo seu 3CX.

## 4. Configure a integração

* **Tempo mínimo de ligação**: defina em segundos o tempo mínimo que uma ligação precisa ter para ser considerada válida pela Elephan.

[![](https://storage.crisp.chat/users/helpdesk/website/-/6/4/7/3/64737efb53739400/31704171-0914-4ed8-b529-98f2f4_1jmf36a.png)](https://downloads.intercomcdn.com/i/o/y556j3ga/2674920890/fc544acd7ded06ef3d42f9043534/image.png?expires=1791376200&signature=f4c9dcd68411fda3056610667a21ccab06ba67f23d64c2360c4ef67271dcddd0&req=diYgEsB8nYlWWfMW1HO4zTVerSfSGPaQQB%2FFGi4nKWQ2CvzWGHU9smuVE0Zn%0AVIWexeT8FUlV%2FV7WQ3Q%3D%0A)

* **Tipo de reunião**: selecione o tipo de reunião que será associado automaticamente às chamadas, para que ocorra a geração dos insights.

[![](https://storage.crisp.chat/users/helpdesk/website/-/a/2/f/8/a2f88dfad33a6000/e9cbb666-8ba2-474c-9863-7f9ed6_13h8233.png)](https://downloads.intercomcdn.com/i/o/y556j3ga/2674919647/6cc918735f439350b2b3473d4a5b/image.png?expires=1791376200&signature=00b299779320ecedaffa7600d2bc2d49cff43c3d02451b12ab8af1daf20601bf&req=diYgEsB%2FlIdbXvMW1HO4zQVZ01wGfKOMEfATZsCxCNOLMnjr2OTsFRyy%2B5gN%0AE%2Fcrsz7iNuPRp6YytnA%3D%0A)

* **Processar chamadas sem Deal**

* **Ativado**: ligações **sem Deal** no CRM são **processadas** normalmente.
* **Desativado**: só processa se existir **Deal com o mesmo número** no CRM.

[![](https://storage.crisp.chat/users/helpdesk/website/-/d/0/0/b/d00ba84b79874000/22cff37e-2a3b-4556-8db9-fff9b7_10zzh5c.png)](https://downloads.intercomcdn.com/i/o/y556j3ga/2674914322/eec966d9423dd451d893c808b748/image.png?expires=1791376200&signature=6b1740f4377961ff02aa4b6d16c3083ffeb16efc0ff8bf05cd5c3d3267bfa2cb&req=diYgEsB%2FmYJdW%2FMW1HO4zWOuRQiOIVwpIZncwQtRYUoIsrSC6KovhMqy8xF8%0AIg%2B70SYnNEj0RTMib%2BU%3D%0A)

## 5. Inclua a URL do servidor 3CX e o Ramal

Ainda no menu lateral, preencha os dois últimos campos:

* **URL do servidor 3CX**: insira o endereço completo do seu servidor 3CX, começando com **https://** (ex: [https://meuservidor.3cx.com.br](https://meuservidor.3cx.com.br/)).

* Use o mesmo endereço que você usa para acessar o console de administração ou o aplicativo web do 3CX.
* Não inclua caminhos depois do endereço (como `/#/office` ou `/webclient`). Informe apenas o domínio.
* **Ramal**: insira o **número do seu ramal** no 3CX (ex: **101**).

* Informe apenas números, exatamente como o ramal aparece no 3CX.
* Com o ramal preenchido, a Elephan importa somente as ligações em que **o seu ramal** participou.

[![](https://storage.crisp.chat/users/helpdesk/website/-/6/1/9/b/619b23ddf92ee800/1ba372c7-24de-4963-b713-f2c395_88vrlt.png)](https://downloads.intercomcdn.com/i/o/y556j3ga/2674916270/d3db945d3f44f878f46440501d53/image.png?expires=1791376200&signature=d656c1716aa777eb92c64adf49f80fda7f50db23685bc211a8d1baef57703217&req=diYgEsB%2Fm4NYWfMW1HO4zaqhZrWqDT%2B3Pc5kswgg%2Ba%2Be%2BxIYYih7Hi42OKd3%0A8QxwFXx60BHiCBON4LY%3D%0A)

## Como encontrar a URL do servidor e o Ramal?

**URL do servidor 3CX**

* Abra o console de administração ou o aplicativo web do 3CX no navegador.
* Copie o endereço da barra do navegador **até o domínio** (ex: `https://meuservidor.3cx.com.br`).
* Se preferir, peça essa informação ao administrador do 3CX da sua empresa.

**Ramal**

* No **aplicativo web ou no aplicativo do 3CX**, o número do seu ramal aparece junto ao seu nome, no seu perfil.
* No **console de administração**, acesse **Usuários**: o ramal de cada pessoa aparece na coluna **Ramal**.
* Se tiver dúvidas, confirme o seu ramal com o administrador do 3CX.

* Após preencher todos os campos obrigatórios, clique em **Salvar**. A Elephan valida as credenciais com o seu servidor 3CX no momento da conexão.

## 6. Conexão realizada

Pronto! A integração com o 3CX foi concluída com sucesso.

## Empresas com vários usuários

A URL do servidor, o Client ID e a API Key são **os mesmos para toda a empresa**. Cada usuário deve conectar o 3CX na própria conta da Elephan usando essas credenciais, e **o que muda de um usuário para outro é apenas o Ramal**.

* **Com ramal**: o usuário recebe somente as ligações do seu ramal.
* **Sem ramal**: o usuário recebe **todas as ligações gravadas da central**.

Administradores também podem definir o ramal de cada usuário em **Configurações > Administração > VoIP**.

## Importante

* A integração depende da validade das credenciais de API. Se a API Key for gerada novamente no 3CX, a integração precisa ser refeita na Elephan.
* Apenas ligações **gravadas** no 3CX são processadas.
* Cada usuário deve informar um ramal diferente. Se dois usuários usarem o mesmo ramal, as mesmas ligações serão processadas para os dois.
* Apenas chamadas realizadas após a ativação serão processadas.
* O processamento segue o fluxo padrão de transcrição e análise da Elephan.

Com isso, suas chamadas passam a ser automaticamente registradas e organizadas dentro da Elephan, facilitando o acompanhamento e garantindo que nenhuma informação importante seja perdida.

Se surgir qualquer dúvida, fale com a gente pelo chat da plataforma ou pelo e-mail [ajuda@elephan.ai](mailto:ajuda@elephan.ai)