Recibir leads
Dar de alta un lead con de dónde llegó y qué aceptó.
Con el permiso «Recibir leads», tu formulario, tus anuncios o tu CRM dan de alta a una persona con de dónde llegó y qué aceptó. Si ya existía —por su teléfono, su correo o tu identificador— se reconoce y no se duplica.
curl -X POST https://app.koonni.com/api/v1/leads \
-H "Authorization: Bearer kn_live_TU_CLAVE" \
-H "Content-Type: application/json" \
-d '{"name": "Laura Gómez", "phone": "+57 300 123 4567", "source": {"channel": "formulario_web", "campaign": "octubre"}, "consent": {"channels": ["whatsapp"], "text": "Acepto que me contacten por WhatsApp."}}'La autorización es obligatoria
consent lleva los canales por los que la persona aceptó que la contacten —whatsapp, llamada, correo— y el texto exacto que aceptó. Es la prueba que pide la ley de protección de datos (Ley 1581). Sin ella el lead no entra: para una ficha sin autorización usa POST /contacts.
Cada autorización queda en un historial que no se borra ni se edita, con su fecha y su texto. En la ficha del cliente se lee en «Autorización de contacto».
El origen
source.channel es uno de formulario_web, anuncio, referido, evento, chat u otro, con su campaña, su plataforma, su enlace y sus utm. Se guarda una vez, el primero: si el mismo lead vuelve a entrar, no lo pisa, pero queda en su historial.
El webhook lead.created sale la primera vez de cada persona.