API de prospectos

Envíe prospectos a FirstFiveMin desde cualquier aplicación. Publique un prospecto con su token de canal y recibe la misma respuesta de cinco minutos. Los prospectos que envíe deben incluir el consentimiento de la persona para ser contactada si desea que la llamemos.

POST /api/speed-to-lead/channel-inbound.php

Autenticación

Envíe su token de canal en el encabezado Authorization, o en X-STL-Channel-Token si su herramienta no puede definir Authorization. Cree el token en la página Integraciones de su cuenta.

Authorization: Bearer YOUR_CHANNEL_TOKEN

Campos

Campo	Tipo	Qué es
`phone`	string	El número de teléfono de la persona. Solo números de EE. UU.
`email`	string	El correo electrónico de la persona. Un prospecto necesita un teléfono o un correo.
`first_name`	string	El nombre de la persona.
`last_name`	string	El apellido de la persona.
`source`	string	De dónde vino el prospecto. Un valor que no esté en la lista se guarda como "form". form, chatbot, api, hosted_page, sms_inbound, voice_inbound, partner, zapier, import, email, meta_lead_ad, ai_shopper, fb_messenger, ig_dm, whatsapp
`source_campaign`	string	Una etiqueta corta de campaña: letras, números, puntos, guiones y guiones bajos, hasta 64 caracteres.
`property_ref`	string	Lo que la persona preguntó: una dirección, un servicio o una propiedad.
`price`	integer	Un precio que la persona mencionó, en dólares enteros.
`language`	string	El idioma en que se le responde a la persona. en, es
`timezone`	string	La zona horaria de la persona, como nombre IANA.
`context`	object	Detalles adicionales que se guardan con el prospecto, como pares de clave y valor.
`source_event_at`	string	Cuándo se comunicó la persona de su lado, en ISO 8601 con zona horaria.
`idempotency_key`	string	Envíe la misma clave al reintentar, y el prospecto no se crea dos veces.
`external_lead_id`	string	El identificador de su propio sistema para este prospecto. Con platform, un prospecto por identificador.
`platform`	string	El nombre del sistema que envía, usado con external_lead_id.
`test`	boolean	true envía un prospecto de prueba: lo ve llegar y nunca se le llama.
`consent`	object	Quién obtuvo el consentimiento de la persona para recibir llamadas, y cuándo. Envíe los tres campos o ninguno: un bloque incompleto se rechaza. Sin él, el prospecto se guarda y el asistente nunca lo llama.
`consent.source`	string	El formulario o sistema que obtuvo el consentimiento.
`consent.reference`	string	Su registro: un identificador de envío, una URL o un identificador de transcripción.
`consent.captured_at`	string	Cuándo se dio el consentimiento, en ISO 8601 con zona horaria. No en el futuro.

Ejemplo

curl -X POST 'https://firstfivemin.com/api/speed-to-lead/channel-inbound.php' \
  -H 'Authorization: Bearer YOUR_CHANNEL_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
    "first_name": "Pat",
    "last_name": "Rivera",
    "phone": "+14155550123",
    "source": "api",
    "property_ref": "123 Main St",
    "language": "en",
    "idempotency_key": "zap-run-8812",
    "consent": {
        "source": "website-form",
        "reference": "form-submission-99812",
        "captured_at": "2026-10-04T15:03:00Z"
    }
}'

La descripción para máquinas (OpenAPI 3.1) está en /api/openapi.json

← FirstFiveMin · English