Envíe leads desde Zapier o Make a Cold Leads
- Para quién
- Equipos que automatizan con Zapier o Make
- El problema
- Los leads llegan por muchas herramientas: widgets de chat, páginas de reserva, pagos de tiendas online, creadores de formularios. Cold Leads no tiene una app en los directorios de Zapier o Make, así que no hay una acción lista para elegir.
- La solución
- Use el paso HTTP genérico que tienen ambas plataformas. Una petición al endpoint de leads con una clave de sitio web crea o actualiza un contacto; en el plan Business, una segunda petición al hook de fase pasa un contacto a customer cuando, por ejemplo, llega un pago.
- Qué obtiene
- Un Zap o un escenario de Make que convierte cualquier activador en un contacto de Cold Leads con etiquetas y fase, y que opcionalmente actualiza la fase más tarde.
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.
Dos endpoints
| Endpoint | Clave | Planes | Qué hace |
|---|---|---|---|
| POST /api/hooks/lead | Clave de sitio web (lk_…) en x-api-key | Todos los planes | Crea un contacto (o añade etiquetas a uno existente) con la fase subscriber o lead y el estado de consentimiento inquiry |
| POST /api/hooks/stage | Clave secreta (sk_…) en x-api-key o Authorization: Bearer | Business | Pasa un contacto existente a cold, subscriber, lead, customer o regular |
Envíe al endpoint de leads solo a las personas que le hayan contactado. Las listas de prospectos en frío van en una importación CSV, que las guarda con el estado de consentimiento B2B outreach.
Zapier
- Elija la app y el evento activadores, por ejemplo una nueva reserva o una nueva entrada de formulario.
- Añada la acción Webhooks by Zapier → POST. Webhooks by Zapier no está disponible en el plan gratuito de Zapier.
- URL: https://coldleads.app/api/hooks/lead. Payload Type: json.
- Data: email, name, company, phone y message asignados desde el activador; tag con un valor fijo como zapier; stage con el valor lead si se trata de leads comerciales.
- Headers: x-api-key con su clave de sitio web. Pruebe el paso; la respuesta es {"ok":true}.
Make
- Empiece el escenario con el módulo activador de la app que recoge los leads.
- Añada HTTP → Make a request con la URL https://coldleads.app/api/hooks/lead y el método POST.
- Headers: x-api-key con su clave de sitio web. Tipo de cuerpo: Raw, tipo de contenido JSON, contenido de la petición como se muestra abajo.
- Active Parse response para ver ok o el código de error en los módulos posteriores.
{
"email": "{{1.email}}",
"name": "{{1.name}}",
"company": "{{1.company}}",
"message": "{{1.message}}",
"tag": "make",
"stage": "lead"
}Pasar un contacto a customer (Business)
Cuando se cierra un negocio en otro sitio, por ejemplo una factura pagada, llame al hook de fase con una clave secreta. Guarde esta clave solo en Zapier o Make; nunca ponga una clave secreta en una página web.
curl -X POST https://coldleads.app/api/hooks/stage \
-H "Content-Type: application/json" \
-H "x-api-key: sk_your_secret_key" \
-d '{ "email": "jane@example.com", "stage": "customer" }'El contacto debe existir ya; de lo contrario, el hook responde not_found. Una fase desconocida devuelve bad_input con la lista de fases válidas.
Límites y errores
- El endpoint de leads acepta 30 peticiones por minuto por dirección IP y 500 al día por clave de sitio web. Zapier y Make envían desde direcciones compartidas, así que una carga masiva de datos antiguos puede provocar rate_limited; envíela en lotes más pequeños o importe en su lugar un archivo CSV.
- El hook de fase acepta 120 peticiones por minuto por clave secreta.
- 402 contact_limit significa que se ha alcanzado el límite de contactos del plan; los contactos existentes se siguen actualizando.
- Cold Leads no llama por su cuenta a Zapier ni a Make: no hay webhooks salientes, así que un Zap no puede activarse con un nuevo contacto de Cold Leads.
Preguntas frecuentes
¿Existe una app oficial de Cold Leads para Zapier o Make?
No. Use Webhooks by Zapier o el módulo HTTP de Make como se describe aquí.
¿Puede un Zap empezar cuando se crea un contacto en Cold Leads?
No. Cold Leads no tiene webhooks salientes. Se puede consultar periódicamente la API REST del plan Business, pero no hay un flujo de eventos para contactos nuevos.
¿Necesito el plan Business?
No para crear contactos: las claves de sitio web funcionan en todos los planes. Cambiar de fase con el hook de fase requiere una clave secreta, que solo se puede crear en el plan Business.