Cold Leads

Envíe respuestas de Typeform, Tally y Google Forms a Cold Leads

Para quién
Equipos que recogen leads con creadores de formularios
El problema
Los creadores de formularios guardan las respuestas en sus propios paneles. Usted quiere que cada respuesta se convierta en un contacto del CRM al que pueda responder, pero Typeform y Tally envían sus webhooks en su propio formato anidado, y Google Forms no tiene webhooks.
La solución
Use la vía que entrega campos planos al endpoint de leads de Cold Leads: un breve activador de Apps Script para Google Forms, y un escenario de Make o un Zap para Typeform y Tally que asigne las respuestas a email, name, company y message.
Qué obtiene
Cada nueva respuesta del formulario se convierte en un contacto de Cold Leads con el estado de consentimiento inquiry, sus etiquetas y la fase que haya elegido.

Las direcciones, los identificadores y los resultados de los ejemplos son ilustrativos. example.com está reservado para documentación, así que una comprobación real de estas direcciones devuelve invalid.

Los ejemplos de código son iguales en todos los idiomas; sus comentarios están en inglés.

Qué vía usar

Creador de formulariosVíaQué necesita
Google FormsUn activador de Apps Script al enviar el formulario hace POST a Cold LeadsUna cuenta de Google propietaria del formulario
TallyTally → Make (o Zapier) → petición HTTP a Cold LeadsUna cuenta de Make; Zapier requiere un plan de pago para webhooks
TypeformTypeform → Make (o Zapier) → petición HTTP a Cold LeadsUna cuenta de Make; Zapier requiere un plan de pago para webhooks

Apuntar un webhook de Tally o Typeform directamente a /api/hooks/lead no funciona: envían las respuestas en estructuras anidadas (data.fields en Tally, form_response.answers en Typeform), y el endpoint espera un campo email en el nivel superior.

Google Forms con Apps Script

  1. Abra el formulario, luego ⋮ → Apps Script, y pegue el script siguiente. Cambie los títulos de las preguntas en FIELDS para que coincidan con su formulario.
  2. En el editor de scripts, abra Triggers → Add Trigger, elija sendToColdLeads, la fuente de eventos From form, el tipo de evento On form submit, y guarde.
  3. Google le pide que autorice el script, porque se conecta a un servicio externo. El activador se ejecuta como la persona que lo creó.
  4. Envíe una respuesta de prueba y revise Executions en el editor de scripts si no aparece ningún contacto.
Apps Script vinculado al formulario
const COLDLEADS_KEY = "lk_your_website_key";
// Form question title → Cold Leads field
const FIELDS = { "Work e-mail": "email", "Name": "name", "Company": "company", "What do you need?": "message" };

function sendToColdLeads(e) {
  const lead = { tag: "google-forms" };
  // If the form collects e-mail addresses automatically, use that address.
  const respondent = e.response.getRespondentEmail();
  if (respondent) lead.email = respondent;
  for (const item of e.response.getItemResponses()) {
    const field = FIELDS[item.getItem().getTitle()];
    if (field) lead[field] = String(item.getResponse());
  }
  const res = UrlFetchApp.fetch("https://coldleads.app/api/hooks/lead", {
    method: "post",
    contentType: "application/json",
    headers: { "x-api-key": COLDLEADS_KEY },
    payload: JSON.stringify(lead),
    muteHttpExceptions: true,
  });
  if (res.getResponseCode() >= 300) console.warn(res.getResponseCode(), res.getContentText());
}

Tally o Typeform con Make

  1. En Make, cree un escenario. Empiécelo con el activador de nuevas respuestas de su creador de formularios, o con Webhooks → Custom webhook, y pegue la dirección de ese webhook en Tally (Integrations → Webhooks) o en Typeform (Connect → Webhooks).
  2. Envíe una respuesta de prueba para que Make conozca la estructura de las respuestas.
  3. Añada HTTP → Make a request: URL https://coldleads.app/api/hooks/lead, método POST, cabecera x-api-key con su clave de sitio web, tipo de cuerpo Raw, tipo de contenido JSON.
  4. En el cuerpo, asigne las respuestas a los campos de Cold Leads como en el ejemplo siguiente. En Typeform, la respuesta de correo es el elemento cuyo tipo es email; en Tally, es el campo cuyo tipo es INPUT_EMAIL.
  5. Ejecute el escenario una vez, compruebe que el contacto aparece en Cold Leads y active la programación.

El cuerpo de la petición, con los marcadores sustituidos por valores asignados en Make:

Cuerpo del módulo HTTP (JSON)
{
  "email": "{{email answer}}",
  "name": "{{name answer}}",
  "company": "{{company answer}}",
  "message": "{{message answer}}",
  "tag": "tally"
}

Tally o Typeform con Zapier

  1. Cree un Zap con el activador de nuevas respuestas de Tally o Typeform.
  2. Añada Webhooks by Zapier → POST (disponible en los planes de pago de Zapier).
  3. URL https://coldleads.app/api/hooks/lead, Payload Type json, Data: email, name, company, message y tag asignados desde el activador, Headers: x-api-key con su clave de sitio web.
  4. Pruebe el paso y publique el Zap.

Preguntas frecuentes

¿Puedo enviar el webhook de Typeform directamente a Cold Leads?

No. La carga de Typeform guarda las respuestas en form_response.answers, y Cold Leads lee un campo email en el nivel superior. Use Make o Zapier para asignar los campos.

¿El Apps Script necesita un plan de pago de Google?

No. Los activadores instalables y UrlFetchApp funcionan con una cuenta de Google normal; se aplican las cuotas diarias de Apps Script de Google.

¿Qué estado de consentimiento reciben estos contactos?

inquiry, igual que los formularios web. Use el endpoint solo para personas que hayan rellenado su formulario, no para listas compradas; impórtelas en su lugar como archivo CSV.