Estás organizando el sábado pensando en el partido del Arsenal en Newcastle. Un amigo en Nueva York necesita la hora de inicio. Luego, alguien en el grupo pregunta qué tal le fue al Arsenal en su último partido como visitante. La primera respuesta está en el calendario de partidos. Para la segunda, necesitas saber de quién es el gol en un “Liverpool 0, Arsenal 1”.
Vas a crear Matchday Notebook, un chatbot de fútbol que busca los próximos tres partidos de la Premier League, te dice los últimos cinco resultados del Arsenal en liga y encuentra su puesto en la clasificación. El ejemplo está fijado al 18 de noviembre de 2026. El partido como visitante contra el Newcastle era el sábado, 21 de noviembre a las 17:30 UTC, o las 12:30 p. m. en Nueva York.
La página del partido del proveedor y el Agente privado coinciden en la hora de inicio. La conversación de Quickchat AI se ejecutó con una simulación de datos públicos, que puedes reproducir a continuación.
Consulta el partido del Newcastle o descarga el kit de Matchday Notebook. Descomprímelo y ejecuta python3 replay.py para ver los tres partidos, los cinco resultados y la fila de la clasificación sin necesidad de una cuenta. El mismo kit incluye la configuración de la Acción y el Main Prompt para conectar tu propia fuente de datos.
1. ¿Qué club y competición seguirá el chatbot?
Primero, fija el club y la liga. La racha del Arsenal en liga puede cambiar dependiendo de si cuentas una noche de Champions. En este cuaderno, Arsenal es el equipo 57 y la liga es la Premier League 2021, también conocida por su código PL.
- Abre el formulario de registro de football-data.org. Introduce tu nombre y tu correo electrónico, acepta las condiciones y selecciona Create account. Consulta tu liga en la lista de cobertura. El plan gratuito incluye la Premier League, con calendarios de partidos y resultados con retraso.
Usa una dirección de correo electrónico que puedas consultar. football-data.org te enviará la clave API allí después de registrarte. El plan gratuito permite 10 peticiones por minuto.
Si ya tienes una cuenta, inicia sesión con tu correo electrónico y tu token de API. Si necesitas otra copia del token, solicítala por correo electrónico usando la dirección con la que te registraste. Guarda el token para el encabezado protegido en el paso 2.
Comprueba tu plan en Subscription y busca tu liga en Available competitions. Este extracto muestra la UEFA Champions League (CL) y la Bundesliga (BL1).
- Para seguir a otro club, búscalo en la lista de equipos de la competición, por ejemplo
GET /v4/competitions/PL/teams. Usa el ID de equipo y el ID de competición devueltos en las solicitudes de partidos a continuación. El inicio rápido de la v4 tiene ambas búsquedas. - Crea un Agente de Quickchat AI, nómbralo Matchday Notebook, y mantenlo privado mientras pruebas. Necesitas créditos disponibles para conversaciones y simulaciones. Abre Identity → AI Persona → Main Prompt y pega las instrucciones a continuación. Las capturas de pantalla y la configuración copiable usan inglés.
Mantén el mismo club en ambos lugares. En el producto, las instrucciones del Agente se encuentran en Identity.
Copia el Main Prompt de Matchday Notebook
You are Matchday Notebook, an Arsenal Premier League companion. Use get_club_fixtures for the schedule, get_recent_results for form and get_league_standings for the league table. For match reads, use an inclusive UTC start date and an exclusive end date. Ask for dates when the window is unclear.
List up to the requested number of TIMED or SCHEDULED fixtures in kickoff order. Give the date, time and timezone; say when the hour is unconfirmed. Flag postponed or cancelled games separately. For form, sort FINISHED matches newest first, take up to five and read full-time scores home first. Judge wins, draws and losses from Arsenal's side. For standings, find Arsenal (team 57) in the TOTAL table. Give the season, position, games played and points.
Keep answers short. Link a match to https://native-stats.org/match/ID using its returned ID, and the Premier League table to https://native-stats.org/competition/PL/. Attribute football-data.org, give the relevant date and identify any snapshot as a snapshot. Quote a retrieval time only if supplied. Keep null scores unknown. Report empty windows, missing scores and failed reads accurately. Stop after a rate limit. Do not predict scores.
2. ¿Cómo obtener el próximo partido del Arsenal?
Empieza con la Acción que responde a la pregunta del grupo sobre la hora de inicio. Una sola petición devuelve ambos clubes, la hora programada y el estado del partido. Deja el filtro de estado abierto para que también aparezca un posible aplazamiento. Un registro TIMED tiene hora de inicio. Para SCHEDULED, dile al lector que la hora está por confirmar.
- Abre Actions & MCPs → Add Action → API Action → Create manually. Fija API Action Name a
get_club_fixturesy When to run a AI decides. En What to ask the user first, añade las entradas de Text requeridasdate_fromydate_to, ambas No default. Sus descripciones son “Primera fecha UTC a incluir, YYYY-MM-DD” y “Primera fecha UTC a excluir, YYYY-MM-DD”. - Para API Endpoint, elige GET e introduce la URL a continuación. Abre Query Params y establece
competitionsen el literal2021. AñadedateFromydateTo. Para cada valor, usa Add AI Data → Parameters para insertar la entrada de fecha correspondiente. Deja Body vacío. - Pega la descripción de abajo en API Action Description y guarda la Acción. En Headers, la credencial irá en una fila
X-Auth-Tokende solo escritura. Configúrala antes de tu primera solicitud. Añade un segundo encabezado normal conAcceptcomo clave yapplication/jsoncomo valor. Usa los mismos dos encabezados en las tres Acciones.
https://api.football-data.org/v4/teams/57/matches
Sigue la ruta de los partidos del equipo desde la referencia del proveedor hasta la acción. El Arsenal está fijo en la URL, la liga en Query Params y las dos fechas provienen de la conversación.
Copia la descripción de la Acción de calendario
Use for Arsenal's upcoming Premier League fixtures in the requested date window. Sort by utcDate ascending. Show TIMED or SCHEDULED matches and flag postponements or cancellations separately. State the window if fewer fixtures are returned.
Los ejemplos de peticiones del proveedor ponen la clave API en X-Auth-Token. Usa ese mismo nombre de encabezado en Headers en get_club_fixtures.
El formulario de inicio de sesión requiere tu correo electrónico y tu token de API. En Quickchat AI, solo el token va en la fila protegida X-Auth-Token.
Ingresa el token de forma privada. El panel de control puede reemplazar una clave guardada. Para que ese encabezado sea de solo escritura, usa la conexión de la cuenta una vez por Acción. Conecta tu cuenta usando la guía de configuración de Quickchat AI en ChatGPT o Claude. Pídele al asistente conectado que prepare el encabezado con un marcador de posición inofensivo usando la instrucción de abajo. Luego, abre tú mismo la pestaña Headers de la Acción, reemplaza el valor en esa misma fila con tu token de football-data.org y selecciona Save changes. Vuelve a abrir el editor y comprueba que muestre [redacted]. Mantén el token en el panel de control y fuera de la conversación.
On Matchday Notebook, set the X-Auth-Token header of get_club_fixtures to the literal value REPLACE_IN_DASHBOARD with is_secret=true. Preserve the rest of the settings. Read the Action back and confirm that the header is secret and the value is [redacted]. Stop before testing.
Este es el encabezado guardado. El proveedor espera el token solo, sin un prefijo Bearer.
Prueba la primera lectura. En Test Response → Test the API, indica una fecha de inicio y el día posterior a la última fecha que te interese. Luego, activa la Acción y pide en AI Preview los próximos tres partidos de liga en ese periodo. Para una consulta en tiempo real, elige fechas próximas. El ejemplo de archivo usó 2026-11-18 y 2026-12-03, por lo que la tarde del 2 de diciembre se incluyó. Comprueba el partido más cercano abriendo el enlace a la fuente. La referencia del filtro de fechas v4 explica por qué la fecha final no se incluye.
En la simulación, el partido como visitante contra el Newcastle cayó el 21 de noviembre, el del Manchester City en casa el 29 de noviembre y el del Brentford como visitante el 2 de diciembre. Si la petición hubiera terminado el 2 de diciembre, se habría omitido el partido del Brentford.
3. ¿Cómo consultar los últimos cinco resultados del Arsenal?
El partido más revelador de este ejemplo terminó Liverpool 0, Arsenal 1. Si el chatbot siempre trata el primer número como el marcador del Arsenal, convierte una victoria como visitante en una derrota. Mantén todos los marcadores en orden local-visitante y usa el ID del equipo para decidir el resultado del Arsenal.
- Crea una segunda API Action llamada
get_recent_results. Usa el mismo endpoint GET, las mismas entradas y chips de fecha y el mismo filtro de competición. Añade la fila de consultastatuscon el valor literalFINISHED. - Establece la descripción de abajo. Repite la configuración del encabezado de solo escritura para
get_recent_results, comprueba que el valor esté oculto y activa la Acción. - Pide los cinco partidos de liga más recientes en un periodo determinado. Para el ejemplo, usa del 1 de octubre al 17 de noviembre de 2026. Ordena por
utcDateantes de seleccionar los cinco. Si en el periodo solo hay tres, muéstralos y ofrece buscar más atrás.
Copiar la descripción de la Acción de resultados
Use for Arsenal's recent Premier League form in the requested date window. Sort FINISHED matches newest first, then take up to five. Use both full-time goals and the home and away team IDs to judge each result from Arsenal's perspective.
Primero busca al Arsenal como equipo visitante y luego lee el gol visitante. El cero del Liverpool significa que mantuvo su portería a cero.
Lee los resultados del más reciente al más antiguo. El Arsenal venció al Hull por 1–0, al Liverpool por 1–0 a domicilio, al Everton por 2–0, al Nottingham Forest por 1–0 a domicilio y al Leeds por 2–1. Suman cinco victorias, siete goles a favor y uno en contra. La ficha del partido contra el Liverpool sirve para probar la lectura del marcador porque el ganador aparece en segundo lugar.
En los datos de prueba guardados, la lista devuelta empieza deliberadamente con el partido de Leeds y termina con el de Hull. Al ordenar por la hora de inicio, el partido de Hull pasa al primer lugar de la respuesta. Abre la respuesta de la Acción junto al chat y compara el primer y el último partido en ambas listas.
Cinco victorias pueden ocultar un detalle importante. Dos de ellas fueron como visitante, por lo que el gol de la victoria está a la derecha.
4. ¿De dónde salen la posición en la liga y los puntos?
Cinco victorias te dicen qué tal fueron las últimas semanas. La posición en la liga también depende de todos los partidos anteriores y de los resultados de los demás. Dale al Agente una Acción de clasificación aparte.
- Llámala
get_league_standings. Elige GET, pega el endpoint de abajo y deja vacíos las entradas, los parámetros de consulta y el cuerpo. Usa AI decides, añade la descripción de abajo y repite la configuración del encabezado de solo escritura para esta Acción. - En Test Response, busca en
standingsla entrada cuyotypeseaTOTAL. Dentro de sutable, busca dondeteam.idsea igual a57. Activa la Acción y pregunta “¿En qué puesto va el Arsenal en la clasificación de la Premier League?” - Compara
position,playedGamesypointscon la fuente para la misma temporada y fecha. El 18 de noviembre, la clasificación de la Premier League en Native Stats mostraba 1º, 10 partidos jugados, 27 puntos. La clasificación actual cambiará a medida que jueguen otros clubes.
https://api.football-data.org/v4/competitions/PL/standings
Copiar la descripción de la Acción de clasificación
Use for the current Premier League table. Find team ID 57 in standings where type is TOTAL. Report season, position, playedGames and points. If the row is missing, say the position is unavailable.
Lee una sola fila en TOTAL. Los 27 puntos cubren los diez partidos de liga en la instantánea.
5. ¿Puedes rastrear el informe del día de partido hasta sus fuentes?
Inicia una nueva conversación en AI Preview. Pregunta por los próximos tres partidos, sigue con “¿Qué tal nos fue en los últimos cinco partidos de liga?”, indica el periodo de los resultados y luego pregunta “¿Y eso en qué puesto de la clasificación nos deja?”. En Inbox, abre el marcador de la Acción ejecutada para cada respuesta. La opción View logs de la Acción te permite comparar los parámetros y la respuesta con lo que vio el seguidor. La guía para crear una API Action muestra dónde encontrar estos controles.
Para obtener el resumen combinado de la jornada que se muestra al principio del artículo, haz la pregunta de abajo con las fechas del ejemplo guardado. Para un resumen actualizado, usa fechas próximas para el calendario y fechas recientes para los resultados.
Arsenal briefing for 18 Nov 2026: next away kickoff this week (UTC), last five since 1 Oct, and table position. Three short lines.
Inspecciona las fechas y el ID del partido en la llamada. En la simulación local, 560651 es el partido contra el Newcastle.
Para una comprobación repetible, abre Conversations → Testing, crea un set de datos y guarda las tres preguntas. Añade las dos preguntas sobre casos límite que se muestran abajo. Ejecuta el set de datos después de cambiar la descripción de una Acción e inspecciona las llamadas junto a las respuestas. Usa una respuesta controlada para probar un estado poco común o un error. Una pregunta hipotética por sí sola sirve para probar la redacción de una respuesta.
Usa las mismas preguntas después de cada cambio. El resultado como visitante detecta un error en el marcador que una prueba solo con partidos en casa pasaría por alto.
| Caso de prueba | Lo que el seguidor debería oír |
|---|---|
Un partido se pospone y ambos goles son null. ¿Fue un empate? | El partido fue aplazado. No hay un marcador registrado. |
Una búsqueda correcta devuelve una lista matches vacía. ¿Está vacía toda la temporada? | No se encontraron partidos en ese periodo. Indica las fechas que buscaste. |
| El proveedor devuelve 401 o 403. | Falló la consulta. Comprueba el token guardado y la cobertura de la competición. |
| El proveedor devuelve 429. | Se alcanzó el límite de peticiones. Espera y vuelve a intentarlo más tarde. |
Una ventana vacía aún tiene una solicitud exitosa. El asistente puede ofrecer ampliar las fechas.
Para una segunda opinión sobre un cambio en la hora de inicio del partido, compárala con las modificaciones de calendario publicadas por la liga. Guarda la fecha programada, la zona horaria y la fecha en que hiciste la consulta. La fuente de datos gratuita puede tener retraso respecto a un cambio de la retransmisión, lo que es importante si alguien está planeando su sábado basándose en la respuesta.
Football data provided by the Football-Data.org API. El ejemplo con fecha utiliza las páginas públicas Native Stats del proveedor. Consulta los planes de datos y límites de peticiones para ver la cobertura y la actualización actuales.
Preguntas frecuentes
¿Qué API de fútbol puedo usar para un chatbot de calendario de partidos?
La API v4 de football-data.org proporciona partidos, resultados y clasificaciones para las competiciones cubiertas. Usa el endpoint de partidos del equipo para el calendario y el estado de forma reciente, y el endpoint de clasificaciones de la competición para la posición en la liga.
¿Los resultados de football-data.org están en vivo en el plan gratuito?
El plan gratuito incluye resultados y calendarios con retraso, clasificaciones de las competiciones cubiertas y 10 peticiones a la API por minuto. Incluye la fuente y la fecha con cada respuesta y revisa tu plan si necesitas resultados en vivo.
¿Cómo cambio el Arsenal por otro equipo?
Encuentra el ID del equipo y la competición del club en football-data.org. Reemplaza el equipo 57 en ambas Acciones de partido, cambia el filtro numérico de la competición y la URL de la clasificación, luego actualiza el nombre del club y el ID del equipo en las instrucciones. Prueba con un partido que reconozcas.
¿Cómo obtengo los últimos cinco partidos desde la perspectiva del equipo?
Filtra por partidos de liga finalizados en un intervalo de fechas, ordénalos por fecha de inicio del más reciente al más antiguo y quédate con un máximo de cinco. Para cada resultado, comprueba si tu equipo jugó en casa o como visitante antes de registrar una victoria, un empate o una derrota. Si encuentras menos de cinco, indica cuántos son.
¿Qué significa un resultado en blanco para un partido pospuesto?
Un resultado en blanco significa que el proveedor no ha proporcionado un total de goles para ese equipo. Mantén visible el estado del partido y deja el resultado como desconocido. Un empate sin goles necesita un partido terminado con dos ceros registrados.
¿Cómo convierto la hora de inicio de un partido a mi zona horaria?
Empieza con la hora de inicio del partido en UTC, usa una zona horaria con nombre como America/New_York y mantén la fecha en la respuesta. El horario de verano y un cambio de día en el calendario pueden afectar a la hora mostrada.