> For the complete documentation index, see [llms.txt](https://ajuda.digitalsac.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.digitalsac.io/digicrm/operacao-uso-do-sistema/configuracoes/configuracoes-gerais/integracoes.md).

# Integrações

**Caminho:** Configurações → Gerais → aba **Integrações**

\[\[FOTO]]

### 8. Integrações → IA (`ai`)

Seção: **Módulo: Inteligência Artificial**

#### 8.1 Transcrição de áudio

| Campo                                           | Chave                 | Para que serve                                                                                                                     |
| ----------------------------------------------- | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Habilitar Transcrição de Áudio                  | `enableTranscription` | `enabled`/`disabled`. Serviço contratado externamente.                                                                             |
| Informe a chave… OpenAI / Groq ou DigitalSac AI | `openai_api_key`      | Chave API para transcrição. Banner detecta provedor/engine (`transcriptionEngine`: groq, digitalsacOwn, openai, digitalsacCustom). |

#### 8.2 Tradução

| Campo                                    | Chave                  | Para que serve                                                                                                            |
| ---------------------------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| Habilitar Tradução                       | `enableTranslation`    | `enabled`/`disabled`. Traduz mensagens para o idioma do usuário.                                                          |
| Informe a chave… OpenAI ou DigitalSac AI | `translation_api_key`  | Chave da API de tradução.                                                                                                 |
| Provedor de Tradução                     | `translation_provider` | `auto`, `nllb`, `openai`, `anthropic`, `gemini`, `grok`, `deepseek`. Auto detecta pela chave; NLLB = tradutor DigitalSac. |

#### 8.3 Reescrita / assistente / análises

| Campo                                           | Chave                             | Para que serve                                                                                                                 |
| ----------------------------------------------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Habilitar Reescrita com IA                      | `enableAIRewrite`                 | `enabled`/`disabled`. Reescrita de mensagens com IA; mesma chave alimenta chat, assistente e inteligências do sistema.         |
| Chave API (reescrita)                           | `aiRewrite_api_key`               | Chave do provedor de LLM.                                                                                                      |
| Provedor de IA                                  | `aiRewrite_provider`              | `auto`, `openai`, `anthropic`, `gemini`, `grok`, `deepseek`, `digitalsac`. Auto pela chave; `sk-` pode ser OpenAI ou DeepSeek. |
| Modelo OpenAI (modelo IA)                       | `aiRewrite_model`                 | Catálogo por provedor (ex.: família GPT-5.x, Claude, Gemini…). Define modelo da reescrita.                                     |
| Tokens Máximos                                  | `aiRewrite_max_tokens`            | Número (regra i18n: 50–100000).                                                                                                |
| Temperatura                                     | `aiRewrite_temperature`           | 0–2; oculto em modelos de reasoning; alguns modelos travam temperature=1.                                                      |
| Geração de imagem com IA na Galeria             | `enableAIGalleryImage`            | `enabled`/`disabled`. Só OpenAI + chave da reescrita; usuário escolhe modelo na geração.                                       |
| Gerar resumo automaticamente ao resolver ticket | `aiRewrite_auto_summary_on_close` | `enabled`/`disabled`. Ao Resolver, gera resumo IA e salva no relatório de Resumos.                                             |

Há banners/dicas de provedor, galeria e famílias de modelos (somente informativos).

***

### 9. Integrações → Notificame Hub (`hub`)

| Campo                                          | Chave           | Para que serve                                                                      |
| ---------------------------------------------- | --------------- | ----------------------------------------------------------------------------------- |
| Chave da conta do Notificame HUB (toggle)      | `hubAccount`    | `enabled`/`disabled`. Ativa o módulo Notificame HUB.                                |
| Informe a chave da sua conta no Notificame Hub | `hubAccountKey` | Token da conta (serviço externo). Validação de token; mostrar/ocultar/copiar/colar. |

***

### 10. Integrações → Connection Hub (`connhub`)

| Campo                                         | Chave                     | Para que serve                                          |
| --------------------------------------------- | ------------------------- | ------------------------------------------------------- |
| Ativar ConnectionHub                          | `connectionHubAccount`    | `enabled`/`disabled`.                                   |
| Informe a chave da sua conta no ConnectionHub | `connectionHubAccountKey` | Chave para API ConnectionHub (contratado externamente). |

***

### 11. Integrações → DigiGO Whatsmeow (`whatsmeow`)

Componente: `ConfiguracoesWhatsMeow.vue`. Fallback: se URL ou token vazios → servidor **global**.

| Campo                            | Chave                   | Para que serve                                  |
| -------------------------------- | ----------------------- | ----------------------------------------------- |
| URL do servidor DigiGO WhatsMeow | `whatsmeow_url_base`    | URL completa da API DigiGO WhatsMeow/ZuckZapGo. |
| Token admin do DigiGO WhatsMeow  | `whatsmeow_admin_token` | Token admin do servidor.                        |
| Limpar e usar global             | (limpa ambas)           | Volta ao servidor global.                       |

***

### 12. Integrações → DigiAPI Baileys (`digiapi`)

Componente: `ConfiguracoesDigiApi.vue`. Sem preenchimento → Configurações Globais (`DIGIAPI_URL_BASE` / `DIGIAPI_API_KEY`).

| Campo                                 | Chave              | Para que serve                                                                          |
| ------------------------------------- | ------------------ | --------------------------------------------------------------------------------------- |
| URL Base DigiAPI (Baileys)            | `digiapi_url_base` | URL do servidor DigiAPI deste tenant.                                                   |
| API Key DigiAPI (Baileys) — x-api-key | `digiapi_api_key`  | Header `x-api-key`. Ambos os campos devem estar preenchidos para sobrescrever o global. |

***

### 13. Integrações → HubPay PIX (`hubpay`)

Componente: `ConfiguracoesHubPay.vue`. Secrets mascarados após salvar.

| Campo                               | Chave                       | Para que serve                                                                                                                                       |
| ----------------------------------- | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| URL do Webhook (somente leitura)    | —                           | `{API}/hubpay/webhook/{tenantId}` — configurar no painel HubPay (`X-Hubpay-Signature`).                                                              |
| Habilitar HubPay                    | `hubpayEnabled`             | `enabled`/`disabled`.                                                                                                                                |
| API Key                             | `hubpayApiKey`              | Enviada só se digitada de novo.                                                                                                                      |
| Webhook Signing Secret              | `hubpayWebhookSecret`       | HMAC do webhook; só se digitado de novo.                                                                                                             |
| Provider padrão                     | `hubpayProvider`            | `asaas`, `mercadopago`, `efi`, `pagarme`, `starkbank`, `stripe`, `iugu`, `pagseguro`, `inter`, `sicredi`, `sicoob`, `openpix`, `bradesco`, `random`. |
| Expiração da cobrança (segundos)    | `hubpayExpiresInSeconds`    | Número ≥ 60; padrão `86400` (24h).                                                                                                                   |
| Enviar QR Code como imagem          | `hubpaySendQrCodeImage`     | `enabled`/`disabled`. QR como imagem + copia-e-cola.                                                                                                 |
| Mostrar status do pagamento no chat | `hubpayPaymentStatusInChat` | `enabled`/`disabled`. Atualiza card no chat via webhook.                                                                                             |

Ações: Testar configuração · Salvar.

***

### 14. Integrações → DigiCalls (`digicalls`)

Componente: `ConfiguracoesDigiCalls.vue`. Chamadas WhatsApp WebRTC no próprio servidor.

| Campo               | Chave              | Para que serve                                            |
| ------------------- | ------------------ | --------------------------------------------------------- |
| Habilitar DigiCalls | `digicallsEnabled` | `enabled`/`disabled`.                                     |
| URL do DigiCalls    | `digicallsUrl`     | URL sem barra final (ex.: `https://calls.digitalsac.io`). |
| API Key             | `digicallsApiKey`  | Header `X-Api-Key`; só reenviada se digitada.             |

Ações: Migrar conexões (cria device por conexão + QR) · Testar · Salvar.

***
