CRM RPA Leads

Visão Geral

API REST segura para criar leads no sistema CRM a partir de aplicações externas

Autenticação Segura

Bearer Token para todas as requisições

REST API

Endpoints HTTP com JSON

Integração Simples

Exemplos prontos em Python

Base URL: https://crmleads-uzhfmx5g.manus.space/api

Autenticação

Todas as requisições devem incluir o token de autenticação

Adicione o header Authorization em todas as requisições:

Authorization: Bearer seu-token-seguro-aqui-trocar-em-producao

⚠️ Importante

Em produção, configure um token seguro através da variável de ambiente EXTERNAL_API_TOKEN

Endpoints Disponíveis

GET/lead/external/health

Verifica se a API está funcionando

Exemplo de requisição:

curl https://crmleads-uzhfmx5g.manus.space/api/lead/external/health

Resposta:

{
  "status": "ok",
  "message": "External API is running",
  "timestamp": "2026-02-23T12:00:00.000Z"
}

Exemplos em Python

Código pronto para usar em suas automações

import requests

# Configuração
API_URL = "https://crmleads-uzhfmx5g.manus.space/api/lead/external"
API_TOKEN = "seu-token-seguro-aqui-trocar-em-producao"

# Headers com autenticação
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_TOKEN}"
}

# Dados do lead
payload = {
    "tenantCode": "0p7n",
    "telefone1": "(11) 98765-4321",
    "textoApi": "Lead capturado via automação RPA"
}

# Fazer requisição
response = requests.post(API_URL, json=payload, headers=headers)

# Verificar resposta
if response.status_code == 201:
    data = response.json()
    print(f"✅ Lead criado! ID: {data['leadId']}")
else:
    print(f"❌ Erro {response.status_code}: {response.json()}")

Notas Importantes

Leads criados via API:

Recebem vendedorId = 0 (indicando origem externa)
Nome padrão: "Lead via API" (editável depois)
Status inicial: "novo"
Campos telefone1 e textoApi são não editáveis no formulário

Segurança:

Sempre use HTTPS em produção
Nunca exponha o token em código público
Use variáveis de ambiente (.env)
Rotacione o token periodicamente

Rate Limiting:

Recomenda-se intervalo de 0.5s entre requisições em lote
Para grandes volumes, considere processamento assíncrono