Recibir leads por webhook

Receive an inbound lead by webhook

curl --request POST \
  --url 'https://api.getnexor.ai/api/public/leads/webhook?token=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "first_name": "Maria",
  "last_name": "Soto",
  "email": "maria@example.com",
  "external_id": "crm-1842"
}
'

import requests

url = "https://api.getnexor.ai/api/public/leads/webhook?token="

payload = {
    "first_name": "Maria",
    "last_name": "Soto",
    "email": "maria@example.com",
    "external_id": "crm-1842"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    first_name: 'Maria',
    last_name: 'Soto',
    email: 'maria@example.com',
    external_id: 'crm-1842'
  })
};

fetch('https://api.getnexor.ai/api/public/leads/webhook?token=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.getnexor.ai/api/public/leads/webhook?token=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'first_name' => 'Maria',
    'last_name' => 'Soto',
    'email' => 'maria@example.com',
    'external_id' => 'crm-1842'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.getnexor.ai/api/public/leads/webhook?token="

	payload := strings.NewReader("{\n  \"first_name\": \"Maria\",\n  \"last_name\": \"Soto\",\n  \"email\": \"maria@example.com\",\n  \"external_id\": \"crm-1842\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.getnexor.ai/api/public/leads/webhook?token=")
  .header("Content-Type", "application/json")
  .body("{\n  \"first_name\": \"Maria\",\n  \"last_name\": \"Soto\",\n  \"email\": \"maria@example.com\",\n  \"external_id\": \"crm-1842\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.getnexor.ai/api/public/leads/webhook?token=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"first_name\": \"Maria\",\n  \"last_name\": \"Soto\",\n  \"email\": \"maria@example.com\",\n  \"external_id\": \"crm-1842\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "lead": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "first_name": "<string>",
    "source": "<string>",
    "metadata": {},
    "created_at": "2023-11-07T05:31:56Z",
    "last_name": "<string>",
    "email": "jsmith@example.com",
    "phone": "<string>",
    "company": "<string>",
    "title": "<string>",
    "campaign_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "assigned_to": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "assigned_user": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>"
    }
  },
  "workflow_run": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "job_id": "<string>",
    "workflow": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>"
    },
    "cadence": {
      "stepIndex": 123,
      "channel": "<string>",
      "attemptNumber": 123,
      "maxAttempts": 123,
      "totalSteps": 123
    }
  },
  "warning": "<string>"
}

{
  "success": true,
  "lead": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "first_name": "<string>",
    "source": "<string>",
    "metadata": {},
    "created_at": "2023-11-07T05:31:56Z",
    "last_name": "<string>",
    "email": "jsmith@example.com",
    "phone": "<string>",
    "company": "<string>",
    "title": "<string>",
    "campaign_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "assigned_to": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "assigned_user": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>"
    }
  },
  "workflow_run": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "job_id": "<string>",
    "workflow": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>"
    },
    "cadence": {
      "stepIndex": 123,
      "channel": "<string>",
      "attemptNumber": 123,
      "maxAttempts": 123,
      "totalSteps": 123
    }
  },
  "warning": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

POST

leads

webhook

Receive an inbound lead by webhook

curl --request POST \
  --url 'https://api.getnexor.ai/api/public/leads/webhook?token=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "first_name": "Maria",
  "last_name": "Soto",
  "email": "maria@example.com",
  "external_id": "crm-1842"
}
'

import requests

url = "https://api.getnexor.ai/api/public/leads/webhook?token="

payload = {
    "first_name": "Maria",
    "last_name": "Soto",
    "email": "maria@example.com",
    "external_id": "crm-1842"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    first_name: 'Maria',
    last_name: 'Soto',
    email: 'maria@example.com',
    external_id: 'crm-1842'
  })
};

fetch('https://api.getnexor.ai/api/public/leads/webhook?token=', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.getnexor.ai/api/public/leads/webhook?token=",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'first_name' => 'Maria',
    'last_name' => 'Soto',
    'email' => 'maria@example.com',
    'external_id' => 'crm-1842'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.getnexor.ai/api/public/leads/webhook?token="

	payload := strings.NewReader("{\n  \"first_name\": \"Maria\",\n  \"last_name\": \"Soto\",\n  \"email\": \"maria@example.com\",\n  \"external_id\": \"crm-1842\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.getnexor.ai/api/public/leads/webhook?token=")
  .header("Content-Type", "application/json")
  .body("{\n  \"first_name\": \"Maria\",\n  \"last_name\": \"Soto\",\n  \"email\": \"maria@example.com\",\n  \"external_id\": \"crm-1842\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.getnexor.ai/api/public/leads/webhook?token=")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"first_name\": \"Maria\",\n  \"last_name\": \"Soto\",\n  \"email\": \"maria@example.com\",\n  \"external_id\": \"crm-1842\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "lead": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "first_name": "<string>",
    "source": "<string>",
    "metadata": {},
    "created_at": "2023-11-07T05:31:56Z",
    "last_name": "<string>",
    "email": "jsmith@example.com",
    "phone": "<string>",
    "company": "<string>",
    "title": "<string>",
    "campaign_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "assigned_to": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "assigned_user": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>"
    }
  },
  "workflow_run": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "job_id": "<string>",
    "workflow": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>"
    },
    "cadence": {
      "stepIndex": 123,
      "channel": "<string>",
      "attemptNumber": 123,
      "maxAttempts": 123,
      "totalSteps": 123
    }
  },
  "warning": "<string>"
}

{
  "success": true,
  "lead": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "first_name": "<string>",
    "source": "<string>",
    "metadata": {},
    "created_at": "2023-11-07T05:31:56Z",
    "last_name": "<string>",
    "email": "jsmith@example.com",
    "phone": "<string>",
    "company": "<string>",
    "title": "<string>",
    "campaign_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "assigned_to": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "assigned_user": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>"
    }
  },
  "workflow_run": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "job_id": "<string>",
    "workflow": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>"
    },
    "cadence": {
      "stepIndex": 123,
      "channel": "<string>",
      "attemptNumber": 123,
      "maxAttempts": 123,
      "totalSteps": 123
    }
  },
  "warning": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

Nexor tiene dos contratos de webhook para recibir leads. Crean leads mediante configuraciones y autenticaciones distintas; no mezcles sus URLs ni sus formatos de mapeo.

Elige el endpoint correcto

Contrato	URL	Enrutamiento	Autenticación
Webhook por puerta	`https://api.getnexor.ai/hooks/:token`	Un agente guardado en la puerta	Token difícil de adivinar en el path
Webhook genérico de la API pública	`https://api.getnexor.ai/api/public/leads/webhook`	`workflow_id` en el query o body	Clave API en `?token=`; también acepta `X-API-Key`

Usa un webhook por puerta cuando una fuente externa siempre envíe leads al mismo agente y necesites actividad por puerta, pausa, deduplicación y validación sin crear registros. Usa la ruta genérica para un sistema sin headers que ya tenga una clave API de Nexor, o cuando cada solicitud deba elegir su agente.

Ambas URLs contienen o aceptan credenciales. Nunca pongas una URL o clave real en documentación, capturas, analítica o mensajes de soporte. Rota la credencial si queda expuesta.

Webhook por puerta

Crea y administra esta puerta desde Conexión personalizada. Su mapa usa rutas de entrada como claves y campos de Nexor como valores:

{
  "contact.email": "email",
  "contact.phone": "phone",
  "contact.name": "first_name"
}

Las rutas con puntos pueden recorrer objetos anidados y posiciones numéricas de arreglos. Si mapeas first_name pero no last_name, Nexor divide un nombre compuesto después de la primera palabra. Después del mapeo, el payload debe contener al menos uno de estos campos: first_name, last_name, email o phone.

Valida sin crear un lead

curl -X POST \
  'https://api.getnexor.ai/hooks/YOUR_WEBHOOK_TOKEN?dry_run=true' \
  -H 'Content-Type: application/json' \
  -d '{"contact":{"name":"Ada Lovelace","email":"ada@example.com"}}'

Una prueba válida devuelve 200, dry_run: true y el lead traducido. No crea un lead. Quita dry_run=true solo después de revisar la identidad traducida y el agente de destino. El endpoint permite 120 solicitudes por dirección IP por minuto. Una puerta deshabilitada devuelve 403; un token inválido devuelve 404; un payload sin campo de identidad devuelve 400. Un lead nuevo devuelve 201. Si la deduplicación está habilitada, Nexor revisa el email cuando existe y, en caso contrario, el teléfono. Un lead existente devuelve 200 con duplicate: true.

Webhook genérico de la API pública

La ruta genérica usa el mismo procesamiento de un lead que POST /leads. Un workflow_id dentro del body JSON tiene prioridad sobre el parámetro del query.

curl -X POST \
  'https://api.getnexor.ai/api/public/leads/webhook?token=YOUR_API_KEY&workflow_id=00000000-0000-4000-8000-000000000000' \
  -H 'Content-Type: application/json' \
  -d '{"first_name":"Ada","email":"ada@example.com","source":"website"}'

Si el sistema permite headers, puedes omitir ?token= y enviar X-API-Key. Sin un mapa de entrada en la clave, el body debe usar los nombres de campo de Nexor. Con un mapa por clave, Nexor resuelve los alias configurados y puede guardar en metadata los campos que no fueron consumidos. POST /api/public/leads/odoo se conserva como un alias de compatibilidad idéntico. No es la integración nativa de Odoo por clave API y no debe usarse como nombre para una conexión personalizada nueva.

Estos endpoints no tienen una pantalla propia para capturar en staging. La guía de Conexión personalizada muestra la superficie real del dashboard donde se administran las puertas.

Autorizaciones

token

string

query

requerido

API key passed in the query string for webhook senders that cannot set headers. Prefer X-API-Key when the sender supports custom headers.

Parámetros de consulta

token

string

API key for senders that cannot set X-API-Key. Do not place it in logs or screenshots.

workflow_id

string<uuid>

Optional agent assignment. A workflow_id in the JSON body overrides this value.

Cuerpo

application/json

Inbound lead payload. If the API key has an intake field map, provider-specific keys are translated first and unrecognized fields may be preserved in metadata. Without a map, use the canonical fields below.

first_name

string

Lead's first name

last_name

string

Lead's last name

string<email>

Lead's email address

phone

string

Lead's phone number

company

string

title

string

city

string

date_of_birth

string<date>

external_id

string

Lead identifier in the source system

source

string

Source label. Defaults to api.

workflow_id

string<uuid>

Agent assignment. This body value overrides the query parameter.

campaign_id

string<uuid>

metadata

object

do_not_contact

boolean

Create or update the lead without starting outreach

Respuesta

An existing lead was matched, or a configured source router intentionally skipped intake

Option 1
Option 2

success

boolean

requerido

Ejemplo:

true

lead

object

requerido

Show child attributes

workflow_run

object

Show child attributes

warning

string

Warning message if lead was created but workflow assignment failed

Última modificación el 7 de septiembre de 2026

Quick Start

Primeros pasos

WhatsApp

Agentes

Integraciones

Cuenta

Asistente

Avanzado

Cumplimiento

Referencia API

Integraciones

Leads

Agentes

Workflow Tools

Bases de conocimiento

Client Tools

Grupos

Campañas

Conversiones

Reportes

Conversaciones

Tags

Background Jobs

Mensajes

Reuniones

Equipo

Procesadores

Recibir leads por webhook

Elige el endpoint correcto

Webhook por puerta

Valida sin crear un lead

Webhook genérico de la API pública

Autorizaciones

Parámetros de consulta

Cuerpo

Respuesta

​Elige el endpoint correcto

​Webhook por puerta

​Valida sin crear un lead

​Webhook genérico de la API pública

Autorizaciones

Parámetros de consulta

Cuerpo

Respuesta

Elige el endpoint correcto

Webhook por puerta

Valida sin crear un lead

Webhook genérico de la API pública