Chaves de API
Este é o passo a passo de dentro do WM CRM. Ainda não tem conta? Conheça os planos.
Chaves de API
As chaves de API permitem que outro sistema (seu site, uma landing page, uma automação) envie leads direto para o WM CRM. Fica em Configurações → Integrações → Chaves de API e é tarefa do gestor. O recurso depende do plano: sem ele, a tela mostra a opção de upgrade.
Criar uma chave
- Clique em Nova chave.
- Dê um nome (ex.: "Integração do site").
- Escolha a origem e o pipeline de destino: todo lead enviado por essa chave entra nessa origem e nesse pipeline.
- Clique em Criar chave.
A chave é exibida uma única vez, logo após a criação. Copie e guarde em local seguro — depois disso ela não aparece mais.
Usar a chave
Envie cada lead com uma requisição POST para /v1/leads, com a chave no cabeçalho:
Authorization: Bearer wmk_live_...
O corpo é um JSON com os dados do lead:
- name — nome (obrigatório)
- email — e-mail
- phone — telefone (apenas dígitos, com DDD)
- company — empresa
- value — valor estimado (número)
- customFields — campos personalizados, no formato
{ "fieldId": "...", "value": "..." }
Onde achar o fieldId
O fieldId é o ID do campo personalizado. Abra Configurações → Leads → Campos, clique no lápis do campo e, no fim do modal Editar campo, está o bloco ID para integração (API) — com botão de copiar. Esse ID não muda quando você renomeia o campo, troca o tipo ou muda a aba.
A origem e o pipeline vêm sempre da chave — não os envie no corpo. O lead entra na primeira etapa do pipeline.
Gerenciar
A lista mostra cada chave com o status (ativa ou revogada), o prefixo (o restante fica oculto) e quando foi usada pela última vez. Para desativar uma chave, use Revogar — a ação é definitiva e não pode ser desfeita; se precisar, crie uma nova.