Ir al contenido principal

Conectar Samu con tu CRM usando n8n

Aprende a conectar Samu con cualquier CRM o sistema externo usando n8n y webhooks.

Escrito por Guillermo Astudillo

Samu tiene integración nativa con HubSpot, Salesforce, Pipedrive, Zoho y Freshsales. Si usas alguna de ellas, conéctalas directamente desde Configuración → CRM.

Si tu CRM no está en esa lista, puedes conectarlo usando n8n — una herramienta de automatización no-code que recibe los datos de Samu vía webhook y los envía a cualquier sistema externo.

❗ Para esta acción es necesario contar con el rol de Admin o un rol personalizado con los permisos correspondientes.

Requisitos

  • Cuenta activa en Samu con acceso a Configuración → API

  • Cuenta en n8n — cloud o instancia self-hosted

  • URL del endpoint de tu CRM y sus credenciales de autenticación


Paso 1 — Crear el webhook en n8n

El webhook es la URL que Samu usará para enviar los datos de cada reunión procesada.

  1. En n8n, crea un nuevo workflow y agrega el nodo Webhook como primer paso.

  2. Configúralo así:

Campo

Valor

HTTP Method

POST

Path

samu-meetings (o el nombre que prefieras)

Response Mode

Respond Immediately

Authentication

None

  1. Guarda. n8n te genera la URL del webhook — cópiala.


Paso 2 — Activar el webhook en Samu

  1. Ingresa a Configuración → API y busca la sección Webhooks.

  2. Activa el toggle para habilitar la integración.

  3. Pega la URL de n8n en el campo URL.

  4. Si configuraste Header Auth en n8n, haz clic en + Agregar header e ingresa el nombre y valor del token.

  5. Haz clic en Enviar prueba para verificar que el webhook responde correctamente.

  6. Guarda la configuración.

✅ Después de enviar la prueba, abre el workflow en n8n y revisa la sección Executions. Si aparece el payload, todo está correctamente conectado.


Paso 3 — El payload que envía Samu

Cada reunión procesada llega a n8n con el siguiente JSON:

{   "_id":          "56732d3dda14d81214634921",   "name":         "Samu.ai - Reunión de capacitación",   "from":         "2024-11-12T21:13:30.121Z",   "to":           "2024-11-12T21:30:00.000Z",   "duration":     45,   "host":         "Andrés Bruzzoni",   "hostEmail":    "[email protected]",   "assistants":   ["[email protected]", "[email protected]"],   "participants": ["Andrés Bruzzoni", "Florencia Estevez"],   "score":        9.15,   "type":         "meeting",   "via":          "GOOGLE",   "summary":      "La llamada se centró en la plataforma de Samu...",   "actionItems":  ["Enviar usuario de prueba", "Esperar documento explicativo"],   "link":         "https://web.samu.ai/meeting/56732d3dda14d81214634921",   "extractor":    { "campo_personalizado": "valor" } }

Los campos más útiles al mapear a tu CRM:

Campo

Descripción

assistants[1]

Email del cliente

participants[1]

Nombre del cliente

summary

Resumen generado por IA

actionItems

Tareas detectadas en la reunión

score

Puntuación de la reunión (0–10)

link

URL directa a la reunión en Samu

extractor.*

Campos personalizados del Extractor

💡 Si configuraste campos personalizados en el Extractor de Samu (ej: presupuesto, próximo paso), los encuentras dentro del objeto extractor. Accedes a ellos con {{ $json.extractor.nombre_del_campo }}.

Paso 4 — Enviar los datos a tu CRM

  1. Agrega el nodo HTTP Request después del Webhook.

  2. Configúralo así:

Parámetro

Valor

Method

POST para crear registros, PATCH para actualizar

URL

El endpoint de tu CRM

Authentication

Bearer Token, API Key o Basic Auth según tu CRM

Body Content-Type

JSON

  1. En el nodo, selecciona Body → JSON y construye el objeto mapeando los campos de Samu:

json

{   "email":          "{{ $json.assistants[1] }}",   "nombre":         "{{ $json.participants[1] }}",   "fecha_reunion":  "{{ $json.from }}",   "resumen":        "{{ $json.summary }}",   "score":           {{ $json.score }},   "proximas_tareas": "{{ $json.actionItems.join(' | ') }}",   "link_samu":      "{{ $json.link }}" }

⚠️ Los nombres de campos a la izquierda deben coincidir exactamente con los que espera la API de tu CRM. Consulta la documentación de tu sistema para verificarlos.

¿Ha quedado contestada tu pregunta?