Secciones

Guía: leads de n8n al CRM de un cliente

Paso a paso para enviar a Agentclic los leads que recoges en n8n.

Ejemplo: recoges leads de un formulario o de otra plataforma en n8n y quieres que entren en el CRM de uno de tus clientes.

1. Token

Crea un token con el permiso «Contactos · leer y escribir», limitado a ese cliente.

2. Id del cliente y de la etapa

Llama a GET /clients para ver el id del cliente y a GET /clients/{clientId}/contacts/options para ver los ids de las etapas y de los campos personalizados.

3. Nodo HTTP Request en n8n

  • Method: POST.
  • URL: https://agentclic.com/api/public/pro/v1/clients/{clientId}/contacts
  • Authentication: Generic Credential Type › Header Auth, con Name «Authorization» y Value «Bearer ack_live_…».
  • Send Body: JSON, con los datos del lead (name, email, phone y, si quieres, stageId y customFields).
json
{
  "name": "{{ $json.nombre }}",
  "email": "{{ $json.email }}",
  "phone": "{{ $json.telefono }}",
  "stageId": "ID_DE_LA_ETAPA"
}

4. Duplicados

Si el lead ya existe (mismo email o teléfono), la API responde 409 CONTACT_EXISTS con el id del contacto en details.contactId, y no se cobra. En n8n puedes activar «Continue On Fail» y, con un nodo IF, actualizar ese contacto con PATCH.

URL base: https://agentclic.com/api/public/pro/v1