Configuração e autenticação

Configure o DigitalSac para usar um sistema comercial próprio. O PerfexCRM continua necessário somente para o licenciamento enquanto essa dependência existir.

Configure estas chaves em Configurações globais (SettingsGlobal), não no .env.

Tokens

• CUSTOM_COMMERCIAL_TOKEN: enviado pelo DigitalSac ao sistema comercial.

• COMPANY_TOKEN: enviado pelo sistema comercial ao DigitalSac ao chamar /api/plans ou /api/tenants.

Use HTTPS e nunca registre tokens ou senhas em logs.

Configurações

Chave	Finalidade	Padrão
COMMERCIAL_PROVIDER	perfex ou custom	perfex
CUSTOM_COMMERCIAL_URL	URL base do sistema comercial	vazio
CUSTOM_COMMERCIAL_TOKEN	Token do sistema comercial	vazio
CUSTOM_PLANS_ENDPOINT	Path de planos	/api/plans
CUSTOM_SERVERS_ENDPOINT	Path de servidores	/api/servers
CUSTOM_DEFAULT_SERVER_ENDPOINT	Path do servidor padrão	/api/servers/default
CUSTOM_DEFAULT_SERVER_ID_ENDPOINT	Path do ID padrão	/api/servers/default-id
CUSTOM_REGISTER_ENDPOINT	Path de cadastro	/digitalsac/gateways/leads/register
SYNC_EXTERNAL_PLANS	Sincroniza planos externos	false
REGISTER_EMAIL_PROVIDER	digitalsac ou custom	digitalsac
COMMERCIAL_PROVIDER_FALLBACK_TO_PERFEX	Fallback ao Perfex	false

Configuração recomendada

COMMERCIAL_PROVIDER=custom
CUSTOM_COMMERCIAL_URL=https://comercial.exemplo.com
CUSTOM_COMMERCIAL_TOKEN=SEU_TOKEN_SEGURO
CUSTOM_PLANS_ENDPOINT=/v1/digitalsac/plans
CUSTOM_SERVERS_ENDPOINT=/v1/digitalsac/servers
CUSTOM_DEFAULT_SERVER_ENDPOINT=/v1/digitalsac/servers/default
CUSTOM_DEFAULT_SERVER_ID_ENDPOINT=/v1/digitalsac/servers/default-id
CUSTOM_REGISTER_ENDPOINT=/v1/digitalsac/register
SYNC_EXTERNAL_PLANS=true
REGISTER_EMAIL_PROVIDER=custom
COMMERCIAL_PROVIDER_FALLBACK_TO_PERFEX=false

Informe somente paths nos campos de endpoint.

Headers enviados pelo DigitalSac

Authorization: Bearer SEU_CUSTOM_COMMERCIAL_TOKEN
apiKey: SEU_CUSTOM_COMMERCIAL_TOKEN
Content-Type: application/json

Headers aceitos pela API do DigitalSac

Authorization: Bearer SEU_COMPANY_TOKEN
Content-Type: application/json

A API /api valida somente o Bearer contra o COMPANY_TOKEN; apiKey não o substitui.

Fonte única

Com SYNC_EXTERNAL_PLANS=true, mantenha o endpoint externo como fonte de verdade. Não altere simultaneamente o catálogo pelo CRUD /api/plans.