API de ingreso de prospectos
Esta API permite enviar leads desde formularios web, landings o cualquier sistema externo y guardarlos en el CRM con atribucion por origen.
Endpoint y autenticacion
Metodo
POST
URL
https://www.plusdiario.com.ar/api/v1/leads/ingest.php
Header obligatorio:
Authorization: Bearer TU_TOKEN_API
El token API se genera desde CRM en Control de Empresa - API de Ingesta de Leads Externos.
Campos recomendados
| Campo | Tipo | Obligatorio | Descripcion |
|---|---|---|---|
| source | string | si | Origen del lead (ej: web_form, landing, ecommerce). |
| nombre | string | si | Nombre del prospecto. |
| telefono | string | si* | Telefono del prospecto. *obligatorio si no viene email. |
| string | si* | Email del prospecto. *obligatorio si no viene telefono. | |
| mensaje | string | si | Consulta o texto enviado por el lead. |
| source_detail | string | no | Detalle del origen (ej: landing-opticas-abril). |
| external_id | string | no | ID externo para dedupe estricto. |
| ad_id / campaign_id | string | no | Datos de atribucion publicitaria. |
| metadata | object | no | UTMs u otros datos auxiliares. |
Ejemplos
JSON
{
"source": "web_form",
"source_detail": "landing-opticas",
"external_id": "lead-123",
"nombre": "Juan Perez",
"telefono": "3585180557",
"email": "juan@email.com",
"mensaje": "Quiero mas informacion",
"ad_id": "120241033668400097",
"campaign_id": "120241033668380097",
"metadata": {
"utm_source": "google",
"utm_campaign": "abril"
}
}
cURL
curl -X POST "https://www.plusdiario.com.ar/api/v1/leads/ingest.php" \
-H "Authorization: Bearer TU_TOKEN_API" \
-H "Content-Type: application/json" \
-d '{
"source":"web_form",
"nombre":"Juan Perez",
"telefono":"3585180557",
"mensaje":"Quiero mas informacion"
}'
Respuesta esperada:
{"status":"ok","lead_id":1234,"deduped":false}