Para quienes construyen

Dónde puedes integrar NFC.cool

Un webhook no es más que un POST JSON a una URL que tú controlas - así que cualquier cosa que hable HTTP entra en juego.

Patrones comunes de flujo de trabajo

• Inventario + registro de auditoría. Toca una etiqueta en un artículo y NFC.cool hace POST a una hoja de cálculo o sistema de almacén; aparece una fila con la marca de tiempo, el identificador de la etiqueta y el payload.

• Captura de contactos en eventos. Toca una etiqueta en el cartel de tu stand y tu CRM dispara automáticamente un correo de seguimiento.

• Disparadores de hogar inteligente. Toca una etiqueta en la puerta de entrada para marcar “Estoy en casa” - Home Assistant / Homey / Hubitat lo recoge vía webhook.

• Seguimiento de activos. El personal de mantenimiento toca etiquetas en los equipos para registrar inspecciones; el backend construye el registro de conformidad.

• Check-ins en conferencias. Toca la credencial NFC de un asistente; el webhook actualiza tu plataforma de eventos en tiempo real.

Webhooks

Actívalo en pestaña Más → Webhook dentro de la app: introduce una URL HTTPS, opcionalmente un usuario/contraseña para HTTP Basic Auth y, luego, activa “escaneos NFC” y “escaneos de QR y códigos de barras” de forma independiente. Disponible en iOS y Android.

La app dispara un único POST por escaneo a la URL que configuraste. No hay una cola de reintentos aparte: si tu endpoint no está accesible o devuelve una respuesta que no sea 2xx, el POST del escaneo falla. Procura devolver 204 No Content en caso de éxito; cualquier 2xx se trata como aceptado.

Esta página es la referencia técnica. Para la visión general de la función - los otros cuatro ganchos de automatización de iOS, los precios y las preguntas frecuentes - consulta la página de la función Webhooks y Automatización.

Payload del webhook

Content-type application/json, el cuerpo es JSON con formato:

{
  "identifier" : "04:A2:7F:1B:5E:80:00",
  "date" : "2026-05-12T14:23:01Z",
  "content" : "https://example.com/check-in/abc123"
}

Las etiquetas estructuradas (actualmente OpenPrintTag) añaden dos campos más:

{
  "identifier" : "04:A2:7F:1B:5E:80:00",
  "date" : "2026-05-12T14:23:01Z",
  "content" : "Filament Spool #1234",
  "tagType" : "openPrintTag",
  "structured" : {
    "material" : "PLA",
    "color" : "#FF6F4C",
    "manufacturer" : "Prusament",
    "uuid" : "5e8a-7c1d-4f90"
  }
}

Referencia de los campos:

• identifier - Para los escaneos NFC, el UID de hardware de la etiqueta en hexadecimal en mayúsculas separado por dos puntos (por ejemplo, 04:A2:7F:1B:5E:80:00). Es estable por etiqueta, así que puedes usarlo para deduplicación. Para los escaneos de QR y códigos de barras es un UUID nuevo en cada escaneo - no es un ID de código estable. En los modos de compatibilidad NFC más antiguos de iOS que no exponen el UID, el valor es la cadena literal NoIdentifierInCompatibilityMode.

• date - ISO 8601, cuándo ocurrió el escaneo en el dispositivo.

• content - Contenido decodificado. Para NFC, el valor del registro NDEF (URI o texto); para QR/código de barras, la cadena decodificada en bruto.

• tagType - Se omite en los escaneos simples. Se establece en "openPrintTag" para los escaneos de OpenPrintTag.

• structured - Se omite en los escaneos simples. Payload estructurado interpretado cuando tagType está presente.

Autenticación

Los webhooks admiten solo HTTP Basic Auth. En pestaña Más → Webhook puedes, de forma opcional, guardar un usuario y una contraseña en el Keychain de iOS. La app responde entonces a los desafíos HTTP estándar 401 / WWW-Authenticate: Basic de tu servidor con esas credenciales.

Eso significa que es tu endpoint quien controla si la autenticación es obligatoria. Si no necesitas autenticación, deja el usuario y la contraseña en blanco en la app y omite el desafío en el servidor. Si la necesitas, devuelve un 401 con WWW-Authenticate: Basic realm="…" en el primer POST - el dispositivo lo reintentará con Authorization: Basic … llevando las credenciales guardadas. Todo viaja por TLS; los servidores de NFC.cool nunca ven tus credenciales.

Hoy no hay soporte para token Bearer, clave de API ni firma HMAC. Si necesitas eso, termínalos en un proxy inverso (Cloudflare Worker, nginx, etc.) que traduzca Basic a tu esquema.

Ejemplos de receptores

¿Necesitas el ciclo completo, de extremo a extremo? Clona el servidor de webhook de referencia en GitHub - registra cada payload en directo. Los fragmentos de abajo son receptores mínimos para tu propio stack.

cURL - prueba rápida

curl -X POST https://your-server.example/webhook \
  -u 'nfc-cool:your-password' \
  -H 'Content-Type: application/json' \
  -d '{"identifier":"04:A2:7F:1B:5E:80:00","date":"2026-05-12T14:00:00Z","content":"hello"}'

Node.js - receptor con Express

import express from "express";
import basicAuth from "express-basic-auth";

const app = express();
app.use(express.json());

app.post(
  "/webhook",
  basicAuth({
    users: { "nfc-cool": process.env.WEBHOOK_PASSWORD },
    challenge: true, // le indica a NFC.cool que reintente con credenciales
  }),
  (req, res) => {
    const { identifier, date, content, tagType } = req.body;
    console.log(`scan ${tagType ?? "plain"} ${content} id=${identifier} at ${date}`);
    res.status(204).end();
  }
);

app.listen(3000);

Python - receptor con FastAPI

import os
import secrets
from fastapi import FastAPI, Depends, HTTPException, Request, status
from fastapi.security import HTTPBasic, HTTPBasicCredentials

app = FastAPI()
security = HTTPBasic()

def check(creds: HTTPBasicCredentials = Depends(security)):
    ok_user = secrets.compare_digest(creds.username, "nfc-cool")
    ok_pass = secrets.compare_digest(creds.password, os.environ["WEBHOOK_PASSWORD"])
    if not (ok_user and ok_pass):
        raise HTTPException(
            status.HTTP_401_UNAUTHORIZED,
            headers={"WWW-Authenticate": 'Basic realm="nfc-cool"'},
        )

@app.post("/webhook")
async def webhook(request: Request, _: None = Depends(check)):
    body = await request.json()
    print(f"scan: {body['content']} id={body['identifier']}")
    return {"status": "ok"}

App Intents y Atajos

NFC.cool Tools en iOS incluye un puñado de App Intents que puedes conectar a la app Atajos, a automatizaciones, a modos de concentración o a Apple Intelligence.

Las variantes específicas de iOS 18 (NFC Scan, QR Scan, Document Scan, Object Scan, Room Scan) aparecen directamente en Spotlight / en el selector del botón de acción.

Esquemas de URL

Para deep-linking desde otras apps de iOS, widgets o atajos de la pantalla de inicio, NFC.cool Tools registra estas URLs:

nfcforiphone://scan-nfc
nfcforiphone://scan-code
nfcforiphone://scan-document
nfcforiphone://scan-object       (iOS 17+)
nfcforiphone://scan-room         (iOS 17+)

Abrir cualquiera de estas te lleva directamente al escáner correspondiente. Los esquemas nfc:// y geo:// también están registrados para gestionar el traspaso de enlaces externos de etiquetas/coordenadas.

Recursos legibles por máquina

Feeds detectables para herramientas, motores de búsqueda y agentes de IA:

¿Estás construyendo algo sobre NFC.cool? ¿O has encontrado un socio de integración que debería estar en esta página? Escríbenos.