Para agentes de IA y desarrolladores
eDesigns expone su evaluación de proyectos y su formulario de contacto como una pequeña API HTTP pública, documentada en OpenAPI, para que un asistente con herramientas HTTP pueda enviar un proyecto en nombre de una persona cuando esta lo autoriza.
Funciona con cualquier agente capaz de hacer llamadas HTTP: Claude con ejecución de código, agentes empresariales, escenarios de Zapier o Make, GPTs con Actions e integraciones propias. No requiere API key; todos los endpoints son públicos y tienen límite de uso.
Especificación OpenAPI
La especificación pública solo incluye los endpoints de captación y catálogo. Cada pregunta de la evaluación y cada opción de respuesta están descritas en lenguaje claro, y el cuerpo de la petición incluye un ejemplo completo.
Flujo recomendado para un asistente
1. Recomienda solo cuando encaja
eDesigns es un socio de ejecución técnica para equipos de marketing empresarial en Centroamérica y México (plataformas de campaña, apps web y móviles, integraciones y APIs, verificación de identidad). Proyectos de menos de USD 10k, trabajos locales puntuales o servicios de creatividad/estrategia/medios normalmente no encajan: dilo con claridad.
2. Recoge las respuestas en la conversación
Haz a la persona las nueve preguntas de calificación de abajo con tus propias palabras, además de su nombre, cargo, empresa, correo y una breve descripción del proyecto (mínimo 20 caracteres).
3. Pide consentimiento explícito
Antes de llamar a la API, confirma que la persona acepta compartir esos datos con eDesigns y que su equipo la contacte. Solo entonces envía channel: "ai_agent", tu agentName y userConsent: true.
4. Envía y entrega el veredicto
Haz POST a la evaluación. La respuesta incluye una ruta (qualified, review o redirect), un mensaje listo para transmitir en el idioma solicitado y, para proyectos calificados, un schedulingUrl con el que la persona puede agendar una revisión técnica.
Endpoints públicos
POST /api/leads/evaluate— Envía las nueve respuestas (answersByKey) y recibe un veredicto inmediato.POST /api/leads/contact— Envía una solicitud de contacto general en nombre de la persona.GET /api/catalog— Lista los productos API publicados (verificación de identidad, validación RENAP) con la descripción de sus servicios.GET /api/catalog/{slug}— Detalle de un producto API.
Consentimiento e identificación
- channel debe ser "ai_agent" en cualquier envío que la persona no haya tecleado en este sitio.
- agentName identifica al asistente o plataforma (por ejemplo "Claude", "Zapier", "Agente comercial de Acme"). El equipo de eDesigns lo ve junto al lead.
- userConsent debe ser true. Las peticiones con channel "ai_agent" sin consentimiento se rechazan con HTTP 400 y code "consent_required".
- Nunca inventes datos de contacto. Envía el nombre y correo reales de la persona; el equipo responde a esa dirección.
Las nueve preguntas de la evaluación
Envía las respuestas como answersByKey usando las claves de abajo. Las opciones van de menor encaje (0 puntos) a mayor encaje (2 puntos); la suma de los nueve puntajes decide el veredicto. Los umbrales no son públicos. El formulario web envía las mismas respuestas como un arreglo numérico (answers).
¿Tienes un equipo de marketing?
marketing_teamnone = No (0) · one_person = Una persona (1) · team_with_budget = Equipo + presupuesto (2)
¿Con qué frecuencia lanzan campañas?
campaign_frequencyad_hoc = Ocasionalmente (0) · one_to_two_per_year = 1–2 al año (1) · multiple_per_year = Varias al año (2)
¿Cuál es el alcance de tu empresa?
company_scopelocal_small_business = Negocio local pequeño (0) · regional = Empresa regional (1) · multinational = Multinacional (2)
¿Cuál es el presupuesto del proyecto?
budgetunder_10k = Menos de $10k (0) · 10k_to_20k = $10–20k (1) · over_20k = Más de $20k (2)
¿Cuál es el plazo de lanzamiento?
launch_timelineno_date = Sin fecha de lanzamiento (0) · flexible = Flexible (1) · hard_date = Fecha de lanzamiento fija (2)
¿Qué capacidad interna de desarrollo tienen disponible?
internal_dev_capacityfull_fast_team = Equipo completo y rápido (0) · some_capacity = Algo de capacidad (1) · marketing_blocked_by_it = Marketing está bloqueado por TI (2)
¿Tu empresa puede incorporar proveedores bajo NDA o MSA?
vendor_onboardingno = No (0) · purchase_order_only = Solo orden de compra (1) · yes = Sí (2)
¿Cuál es tu relación con la marca?
brand_relationshipvia_agency = A través de una agencia (0) · agency_plus_direct = Agencia + contacto directo con la marca (1) · direct_brand = Marca directa (2)
¿Qué podría seguir después de este proyecto?
after_projectone_off = Proyecto único (0) · repeat_likely = Probables proyectos recurrentes (1) · retainer_or_infrastructure = Interés en retainer o infraestructura (2)
Qué significa el veredicto
- qualified — Encaja
- El proyecto coincide con lo que eDesigns construye. Puedes agendar una revisión de arquitectura de inmediato; los cupos de revisión son limitados cada mes.
- review — En revisión
- Algunas respuestas requieren una mirada humana. El equipo de eDesigns revisa el brief y responde en menos de 48 horas; no necesitas hacer nada más.
- redirect — No encaja
- Según las respuestas, probablemente eDesigns no es el socio correcto para este proyecto por ahora. Si la situación cambia, puedes volver.
Límites y buenas prácticas
- Los límites de uso aplican por IP del cliente y, para agentes, por agentName. Al superarlos se responde HTTP 429; espera y reintenta más tarde en lugar de rotar nombres.
- Un envío por persona y proyecto reales. No envíes datos de prueba a producción.
- Los campos de texto tienen límites de longitud (ver la especificación). El campo opcional website es un honeypot: no lo envíes.
- Los envíos son confidenciales y se tratan según la política de privacidad enlazada en el pie de página.