Para agentes de IA y desarrolladores

eDesigns documenta sus endpoints de evaluación, contacto y catálogo en OpenAPI. La lectura del catálogo es pública; todo envío requiere verificación humana con Cloudflare Turnstile, incluidos los agentes de IA.

Los asistentes pueden consultar el catálogo y ayudar a preparar respuestas. Para enviar, dirige a la persona al formulario web y su verificación de seguridad. El consentimiento y el nombre del agente no sustituyen la verificación.

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. 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. 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. 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. 4. Continúa en el sitio web

    Dirige a la persona al formulario de evaluación para completar la verificación humana y enviar. Todo POST requiere un turnstileToken nuevo, con la acción del formulario y un dominio autorizado. Nunca afirmes que se envió sin una respuesta exitosa.

Endpoints públicos

Consentimiento e identificació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).

  1. ¿Tienes un equipo de marketing? marketing_team

    none = No (0) · one_person = Una persona (1) · team_with_budget = Equipo + presupuesto (2)

  2. ¿Con qué frecuencia lanzan campañas? campaign_frequency

    ad_hoc = Ocasionalmente (0) · one_to_two_per_year = 1–2 al año (1) · multiple_per_year = Varias al año (2)

  3. ¿Cuál es el alcance de tu empresa? company_scope

    local_small_business = Negocio local pequeño (0) · regional = Empresa regional (1) · multinational = Multinacional (2)

  4. ¿Cuál es el presupuesto del proyecto? budget

    under_10k = Menos de $10k (0) · 10k_to_20k = $10–20k (1) · over_20k = Más de $20k (2)

  5. ¿Cuál es el plazo de lanzamiento? launch_timeline

    no_date = Sin fecha de lanzamiento (0) · flexible = Flexible (1) · hard_date = Fecha de lanzamiento fija (2)

  6. ¿Qué capacidad interna de desarrollo tienen disponible? internal_dev_capacity

    full_fast_team = Equipo completo y rápido (0) · some_capacity = Algo de capacidad (1) · marketing_blocked_by_it = Marketing está bloqueado por TI (2)

  7. ¿Tu empresa puede incorporar proveedores bajo NDA o MSA? vendor_onboarding

    no = No (0) · purchase_order_only = Solo orden de compra (1) · yes = Sí (2)

  8. ¿Cuál es tu relación con la marca? brand_relationship

    via_agency = A través de una agencia (0) · agency_plus_direct = Agencia + contacto directo con la marca (1) · direct_brand = Marca directa (2)

  9. ¿Qué podría seguir después de este proyecto? after_project

    one_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