Caminho de Acesso

Menu ▸ Configurações ▸ Origens de Lead / Origens de Oportunidade / Ofertas
(slug é gerado e utilizado como atributo interno para facilitar integrações e importações)

Permissões Necessárias

• Administrador do CRM: criar/editar Origens de Lead, Origens de Oportunidade e Ofertas.
• Desenvolvedores/Analistas de Integração: consumir as APIs com referência ao slug.
• Usuários com permissão de Importação: utilizar slug em arquivos modelo de importação.

Visão Geral

No EleveCRM, o slug é usado como uma chave única, legível e estável para identificar registros em atributos como:

• Origens de Lead
• Origens de Oportunidade
• Ofertas

Ele substitui IDs numéricos e nomes longos, trazendo consistência para APIs e processos de importação.

Benefícios principais:

• Facilita chamadas em APIs (POST, PUT, GET).
• Garante consistência entre sistemas diferentes.
• Evita depender de IDs internos que podem variar.
• Torna importações de dados mais simples e menos propensas a erro.

Funcionalidades e Recursos

• APIs
  • Endpoints aceitam slug no lugar de IDs numéricos.
  • Exemplo:
    • Sem slug: POST /oportunidades { origem_id: 9847 }
    • Com slug: POST /oportunidades { origem_slug: "evento-ajorpeme" }
• Importação de Dados
  • Slugs podem ser usados em colunas de referência (Origens, Ofertas etc.).
  • Exemplo em CSV: oportunidade, origem_slug, oferta_slug "CRM Eleve", "feira-tecnologia-2025", "plano-plus"
• Integração entre sistemas
  • ERP, CRM antigo ou planilhas podem usar o slug como “código universal”.
  • Exemplo:
    • No ERP: cliente tem ID 4591
    • No CRM: cliente tem ID 237
    • Ambos usam slug acme-ltda → integração automática.

Boas Práticas / Recomendações

• ✅ Sempre único dentro do tipo de recurso (não podem existir duas ofertas com o mesmo slug).
• ✅ Imutável: mesmo que o nome da origem/oferta mude, o slug deve permanecer o mesmo.
• ✅ Determinístico: derivado do campo “nome” com normalização:
  • minúsculo
  • sem acentos
  • espaços → hífen
  • Exemplo: “Plano Plus” → plano-plus.
• ⚠️ Alterar o slug pode quebrar importações e integrações já existentes.