> For the complete documentation index, see [llms.txt](https://digitalsac.gitbook.io/digicalls/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://digitalsac.gitbook.io/digicalls/comece-aqui/bem-vindo-a-ao-digicalls.md).

# 👋Bem vindo (a) ao DigiCalls

{% hint style="info" %}
É um prazer receber você aqui.

Neste tópico vamos apresentar os principais assuntos sobre o funcionamento do **DigiCalls**, a solução da **DigitalSac** para chamadas, integrações de voz e atendimento por ligação.
{% endhint %}

***

### 📞 O que é o DigiCalls?

O **DigiCalls** é uma solução que permite integrar chamadas ao seu sistema de atendimento, CRM, plataforma SaaS, PABX ou automação.

Com ele, você pode realizar, receber e controlar ligações dentro do seu próprio ambiente, utilizando recursos como:

* 📲 **Click to Call**
* 🔌 **API**
* 🔄 **Websocket**
* 🧩 **Webhooks**
* ☎️ **SIP**
* 🎧 **Atendimento humano**
* 🤖 **Automação com IA**
* 💾 **Gravação local ou S3**

{% hint style="success" %}
A proposta do DigiCalls é permitir que empresas adicionem chamadas aos seus fluxos de atendimento com mais controle, flexibilidade e escalabilidade.
{% endhint %}

***

### 🚀 O que é possível fazer usando o DigiCalls?

Com o **DigiCalls**, você pode criar vários tipos de operação com chamadas e voz.

#### Exemplos de uso

| Recurso                   | Descrição                                                      |
| ------------------------- | -------------------------------------------------------------- |
| 🤖 Atendimento com IA     | Automatize ligações e respostas usando inteligência artificial |
| 👥 Fila de atendimento    | Direcione chamadas para atendentes ou setores específicos      |
| 📲 Click to Call          | Inicie chamadas com apenas um clique dentro do sistema         |
| 🧾 CRM e ERP              | Integre chamadas em cadastros, tickets e históricos            |
| 🏢 Portaria e condomínios | Automatize chamadas para moradores ou responsáveis             |
| 🎧 Multiatendimento       | Use como complemento em plataformas de atendimento             |
| 📅 Agendamentos           | Confirme consultas, reuniões ou atendimentos por chamada       |
| 🔔 Webhooks               | Receba eventos das chamadas em tempo real                      |
| 💾 Gravações              | Grave ligações localmente ou em armazenamento externo          |

***

### 🔁 É possível fazer chamadas simultâneas?

Sim.

No **DigiCalls SelfHosted**, a quantidade de chamadas simultâneas depende da estrutura do servidor ou VPS utilizada.

{% hint style="warning" %}
Antes de definir a quantidade de canais por cliente, é importante validar se a VPS ou servidor suporta a operação desejada.
{% endhint %}

#### Recomendação de estrutura

| Uso                  | Recursos sugeridos |
| -------------------- | ------------------ |
| Ambiente mínimo      | 2 CPU / 4 GB RAM   |
| Ambiente recomendado | 8 CPU / 16 GB RAM  |
| Rede recomendada     | Tráfego de 1 GB/s  |

{% hint style="info" %}
Quanto maior a quantidade de canais simultâneos, maior será a necessidade de CPU, memória e estabilidade de rede.
{% endhint %}

***

### ⚠️ Quais os riscos de bloqueio ou banimento?

O risco depende diretamente da forma de uso.

Chamadas para números desconhecidos, excesso de tentativas, uso abusivo ou denúncias de usuários podem aumentar o risco de bloqueios.

#### Boas práticas

* ✅ Ligue apenas para contatos autorizados
* ✅ Evite chamadas em massa sem contexto
* ✅ Respeite horários comerciais
* ✅ Trabalhe com clientes ativos ou leads consentidos
* ✅ Evite insistência excessiva
* ✅ Mantenha histórico e contexto do atendimento

{% hint style="danger" %}
O DigiCalls fornece a estrutura técnica para chamadas, mas a responsabilidade pelo uso correto da operação é sempre do cliente.
{% endhint %}

***

### 🧩 Qual módulo devo utilizar?

Tudo depende do seu caso de uso.

Abaixo estão os principais módulos disponíveis no **DigiCalls**.

***

### 📲 Click to Call

O **Click to Call** é simples, rápido e fácil de integrar.

Ele permite iniciar uma chamada com apenas um clique dentro do seu sistema, CRM, painel administrativo ou plataforma de atendimento.

#### Indicado para

* CRMs
* Sistemas de atendimento
* Painéis internos
* WordPress
* Sites
* ERPs
* Plataformas SaaS

{% hint style="success" %}
Ideal para quem quer adicionar chamadas rapidamente sem criar uma integração complexa.
{% endhint %}

***

### 🔌 API / Websocket

A integração via **API e Websocket** permite criar fluxos mais avançados de chamadas.

Com ela, seu sistema pode iniciar chamadas, receber eventos, acompanhar status e controlar o comportamento da ligação de forma personalizada.

#### Indicado para

* Plataformas de atendimento
* Sistemas multitenant
* Soluções com fila de atendimento
* Integrações com IA
* Dashboards em tempo real
* Operações com controle dinâmico de chamadas

#### Exemplos de uso

| Evento                 | Possibilidade                        |
| ---------------------- | ------------------------------------ |
| 📞 Chamada iniciada    | Registrar no ticket ou CRM           |
| ✅ Chamada atendida     | Atualizar status do atendimento      |
| ❌ Chamada recusada     | Disparar automação ou nova tentativa |
| ⏱️ Chamada encerrada   | Salvar duração e histórico           |
| 💾 Gravação disponível | Vincular gravação ao cliente         |

***

### 🔔 Webhook

Os **Webhooks** permitem que o seu sistema receba eventos das chamadas em tempo real.

Com isso, você pode registrar logs, atualizar tickets, disparar automações, salvar históricos e integrar o DigiCalls com outras ferramentas.

#### Exemplos de eventos

* 📞 Chamada iniciada
* ✅ Chamada atendida
* ❌ Chamada recusada
* 🔚 Chamada encerrada
* ⚠️ Falha na chamada
* 📡 Status do canal
* 💾 Gravação disponível

{% hint style="info" %}
Webhooks são ideais para integrar o DigiCalls com sistemas externos, automações, CRMs e plataformas próprias.
{% endhint %}

***

### ☎️ SIP

A integração via **SIP** é indicada para quem já utiliza PABX, discadores, softphones ou centrais telefônicas.

Com ela, é possível conectar o DigiCalls a uma estrutura de telefonia já existente.

#### Indicado para

* PABX
* Softswitches
* Discadores
* Softphones
* Centrais de atendimento
* Operações com ramais
* Ambientes com SIP Trunk

{% hint style="success" %}
Ideal para empresas que já trabalham com telefonia e querem integrar chamadas ao ambiente DigiCalls.
{% endhint %}

***

### 🖥️ DigiCalls SelfHosted

No modelo **SelfHosted**, o DigiCalls é instalado em uma VPS ou servidor do cliente.

A **DigitalSac** realiza a instalação, deixa o ambiente funcionando e fornece suporte conforme o plano contratado.

#### Incluso no SelfHosted

* 🛠️ Instalação do ambiente
* ⚙️ Configuração inicial
* 📞 Ativação dos canais
* 🔄 Atualizações
* 🧑‍💻 Suporte técnico
* 📆 Licença anual

{% hint style="warning" %}
A quantidade de canais deve ser definida conforme a capacidade da VPS ou servidor utilizado.
{% endhint %}

***

### 🧠 Como escolher o melhor módulo?

| Necessidade                      | Módulo recomendado |
| -------------------------------- | ------------------ |
| Quero ligar com 1 clique         | 📲 Click to Call   |
| Quero integrar com meu sistema   | 🔌 API             |
| Quero eventos em tempo real      | 🔄 Websocket       |
| Quero automatizar ações externas | 🔔 Webhook         |
| Já tenho PABX ou discador        | ☎️ SIP             |
| Quero ambiente próprio           | 🖥️ SelfHosted     |

***

### ✅ Resumo

O **DigiCalls** foi criado para empresas que querem adicionar chamadas aos seus sistemas de forma flexível, escalável e integrada.

Você pode usar o DigiCalls para:

* Atendimento humano
* Atendimento com IA
* Click to Call
* Webhooks
* Integrações com CRM
* Integrações com PABX
* Plataformas multitenant
* Sistemas próprios
* Gravações de chamadas
* Automações de voz

{% hint style="success" %}
A escolha do módulo ideal depende do seu projeto, da sua estrutura e do nível de controle que você precisa ter sobre as chamadas.
{% endhint %}