Pré-requisitos
- Uma conta ativa do SalesMind AI
- Acesso a Configurações no seu painel do SalesMind AI
Passo 1: Gerar sua chave de API
- Vá em Configurações de API do SalesMind AI (Configurações > aba API).
- Encontre a seção Chave de API.
- Clique em Gerar chave de API.
- Copie a chave — você vai precisar dela no próximo passo.
💡 Dica: Guarde sua chave de API em um lugar seguro. Você não poderá vê-la de novo depois de sair da página.
Passo 2: Autorizar na documentação da API
- Abra a documentação da API do SalesMind AI.
- Clique em Authorize no topo da página.
- Cole sua chave de API no campo de entrada.
- Clique em Authorize e depois em Close para fechar a janela.
Agora você está autenticado e pronto para fazer chamadas de API.
Passo 3: Fazer sua primeira requisição de API
Vamos testar com uma requisição GET para obter seus agentes.
- Na documentação da API, navegue até GET /v1/agent.
- Expanda a seção da requisição.
- Clique em Try it out.
- Role para baixo e clique em Execute.
Você verá o comando cURL e a resposta retornada pela API. Uma resposta bem-sucedida confirma que sua conexão está funcionando.
Passo 4: Integrar e automatizar
Com o acesso à API confirmado, agora você pode:
- Explorar outros endpoints (leads, campanhas, sequências)
- Conectar o SalesMind AI ao seu CRM ou ferramentas internas
- Criar fluxos de trabalho automatizados acionados por eventos do SalesMind AI
👉 Observação: Verifique na documentação da API os limites de taxa e a paginação antes de criar integrações em produção.
Autenticação e URL base
Envie cada requisição para a URL base https://api.sales-mind.ai/. Todos os endpoints públicos ficam sob o caminho /v1.
Autentique-se com sua chave de API no cabeçalho X-API-KEY — não com um token Bearer. Adicione-o a cada requisição:
curl "https://api.sales-mind.ai//v1/agent" \
-H "X-API-KEY: your-api-key"
Se a chave estiver ausente, incorreta ou inativa, a API retorna 401 Unauthorized.
Limites de taxa
A API permite 100 requisições a cada 10 segundos. É uma janela deslizante, vinculada à sua X-API-KEY (ou ao seu endereço IP se nenhuma chave for enviada). Os limites se aplicam apenas aos endpoints /v1.
Cada resposta inclui cabeçalhos de limite de taxa, em duas famílias por compatibilidade:
| Cabeçalho | Significado |
|---|---|
X-RateLimit-Limit / RateLimit-Limit | Máximo de requisições permitidas na janela |
X-RateLimit-Remaining / RateLimit-Remaining | Requisições restantes na janela atual |
X-RateLimit-Reset / RateLimit-Reset | Segundos até a janela reiniciar |
Se você exceder o limite, a API retorna 429 Too Many Requests com um cabeçalho Retry-After. Aguarde esses segundos e tente de novo.
Adicionar leads a uma lista de leads
Adicione leads diretamente a uma lista existente como JSON — sem upload de CSV.
Endpoint: POST https://api.sales-mind.ai//v1/lead_list/{id}/leads
Envie um array JSON de objetos de lead. Cada objeto aceita:
| Campo | Obrigatório | Notas |
|---|---|---|
linkedInUrl | Sim | Linhas sem este valor são ignoradas |
firstName | Não | |
lastName | Não | |
phone | Não | |
emails | Não | Texto separado por vírgulas |
curl -X POST "https://api.sales-mind.ai//v1/lead_list/123/leads" \
-H "X-API-KEY: your-api-key" \
-H "Content-Type: application/json" \
-d '[{"linkedInUrl":"https://www.linkedin.com/in/jane-doe","firstName":"Jane","lastName":"Doe","emails":"jane@acme.com"}]'
Como a importação é executada depende de quantos leads válidos você envia:
- 1 lead ou menos: importado na hora. Você recebe
200com{received, imported, skipped}. - Mais de 1 lead: colocado na fila e processado em segundo plano. Você recebe
202com{received, queued, skipped}.
A importação é aditiva e idempotente — nunca remove leads existentes e sobrevive às atualizações da lista. Se sua chave não for dona da lista, você recebe 403; se a lista não existir, você recebe 404.
Gerenciar seus agentes
Crie e gerencie seus agentes (equipes) pelos endpoints /v1/agent.
| Método | Endpoint | Finalidade |
|---|---|---|
| GET | https://api.sales-mind.ai//v1/agent | Listar seus agentes |
| GET | https://api.sales-mind.ai//v1/agent/{id} | Obter um agente |
| POST | https://api.sales-mind.ai//v1/agent | Criar um agente |
| PUT | https://api.sales-mind.ai//v1/agent/{id} | Atualizar um agente |
| DELETE | https://api.sales-mind.ai//v1/agent/{id} | Excluir um agente |
Endpoints de analytics
Obtenha analytics de conversa limitados a um único agente, sender ou campanha. Você escolhe o escopo no caminho — não há parâmetro groupBy.
Cada widget segue o padrão https://api.sales-mind.ai//v1/{agent|sender|campaign}/{id}/…:
| Widget | Sufixo do caminho | Parâmetros de consulta |
|---|---|---|
| Distribuição de personas / fit-score | /personas/distribution | from, to |
| Funil de conversa | /funnel | status[], from, to, tags[] |
| Motor de mensagens | /messaging-engine | status[], from, to |
As datas usam o formato ISO. A janela do motor de mensagens é por padrão os últimos 7 dias e limitada a 92 dias. Você recebe 403 se não for membro do agente dono do escopo.
curl "https://api.sales-mind.ai//v1/agent/42/funnel?status[]=active&from=2026-08-01&to=2026-08-27" \
-H "X-API-KEY: your-api-key"
Próximos passos
- Conheça os recursos de Autopilot e CRM no SalesMind AI para entender quais dados você pode obter pela API
- Explore a integração com o Zapier se preferir uma abordagem de automação sem código
FAQ
Preciso me autenticar com um token Bearer?
Não. O SalesMind AI usa o cabeçalho X-API-KEY. Coloque sua chave de API ali em cada requisição.
O que acontece se eu atingir o limite de taxa?
Você recebe uma resposta 429 com um cabeçalho Retry-After. Aguarde esses segundos e envie a requisição de novo.
Posso adicionar leads sem enviar um CSV?
Sim. Envie um array JSON para POST https://api.sales-mind.ai//v1/lead_list/{id}/leads. Cada lead precisa de uma linkedInUrl.
Por que minha importação de leads retornou 202 em vez de 200?
Mais de um lead é importado em segundo plano, então você recebe 202. Um único lead é importado na hora e retorna 200.
Como agrupo os analytics por campanha?
Coloque o escopo no caminho da URL, como /v1/campaign/{id}/funnel. Não há parâmetro groupBy.