No Spark, Desenvolvedores é a área em Configurações → Desenvolvedores onde a organização liga o acesso programático ao CRM e administra as credenciais usadas pelo gateway público. Não é um “modo” que muda a interface do dia a dia do time de atendimento: é um interruptor de API e um cofre de chaves para integrações, formulários públicos, ERPs e scripts.Documentation Index
Fetch the complete documentation index at: https://docs.crmspark.com.br/llms.txt
Use this file to discover all available pages before exploring further.
Para que serve
- Permitir que sistemas externos chamem endpoints oficiais (REST + JSON) em nome da organização, não de um usuário específico.
- Pausar todas as integrações de uma vez desligando o ambiente, sem apagar as chaves já criadas.
- Separar credenciais por projeto (produção, homologação, parceiro) usando várias chaves secretas com nomes claros.
Ambiente habilitado x desabilitado
| Estado | Efeito |
|---|---|
| Desabilitado | Não há uso válido das chaves contra o gateway até você habilitar de novo. As chaves permanecem armazenadas no sistema. |
| Habilitado | As chaves passam a autenticar requisições conforme as regras de cada endpoint. Na primeira ativação, o Spark cria a chave pública e a primeira chave secreta e oferece um momento seguro para copiar. |
Chave pública e chaves secretas
| Tipo | Prefixo típico | Papel |
|---|---|---|
| Chave pública | pk_ | Identifica a organização em fluxos que a documentação da API marca como uso de chave pública. |
| Chave secreta | sk_ | Autentica operações que exigem chave privada; é a credencial sensível — trate como senha. |
Ativar ou desativar uma chave secreta
Na lista de chaves secretas existe controle de chave ativa na API. Desativar uma chave específica interrompe só os clientes que usam aquela credencial, sem desligar o ambiente inteiro nem as outras chaves.Remover uma chave
É possível remover uma chave secreta da lista. Enquanto houver apenas uma chave secreta, a interface não permite excluí-la (evita deixar o ambiente sem credencial secreta útil). Para trocar a última chave de forma segura, crie uma nova, atualize as integrações e só então remova a antiga — ou use desativar temporariamente.Onde isso aparece no produto
- Formulários de captação públicos (link ou iframe) carregam o fluxo com a chave na URL — o mesmo tipo de credencial gerenciada aqui; veja Formulários de captação.
- Demais integrações server-to-server seguem o cabeçalho e o tipo de chave descritos na referência da API.
Referência técnica
Passo a passo de habilitação, cabeçalhoX-API-Key, base URL e boas práticas de integração estão na Introdução à API (aba Referência da API).