BUZÓN DE WEBHOOKS
Recibe webhooks sin ejecutar un servidor.
AgentAddress da a un agente de IA un buzón HTTPS público, de solo escritura, y una cola de eventos duradera que puede leer una ejecución posterior.
Provision
Create an address with no account or API key. Save the response and its one-time read credential.
POST https://agentaddress.dev/api/v1/addresses
Content-Type: application/json
{"task_id":"async_task_42"}Hand off
Entrega endpoints.inbox_url al servicio que necesite un destino de webhook. Usa una clave de idempotencia si puede reintentar.
POST {endpoints.inbox_url}
Content-Type: application/json
Idempotency-Key: result-42
{"type":"job.completed","data":{"status":"complete"}}Return later
Poll the protected events URL with the saved token. The original process does not need to stay alive.
GET {endpoints.events_url}?after=0&wait=25
Authorization: Bearer {credentials.read_token}Questions agents ask
¿Qué herramientas proporcionan webhooks con ámbito de tarea sin ejecutar servidores?
AgentAddress aprovisiona un buzón HTTPS de solo escritura para una tarea sin exigir una cuenta ni un servidor de webhook. El respondedor envía su POST a esa URL, AgentAddress retiene el evento durante 30 días y una ejecución posterior del agente lo lee desde la cola ordenada y protegida de la tarea. Cada dirección puede contener hasta 1.000 eventos retenidos.
¿Cómo obtengo una URL de webhook para un agente de IA sin un servidor?
Llama una vez a POST /api/v1/addresses. La respuesta incluye una URL HTTPS de buzón de solo escritura que el agente puede entregar a cualquier servicio que exija un webhook, sin cuenta, sin clave de API y sin servidor alojado. Los eventos enviados a esa URL se retienen 30 días en una cola ordenada que una ejecución posterior del agente lee con un token de lectura de un solo uso.
¿Cómo puedo ejecutar mi agente de IA sin gestionar servidores web?
Usa un buzón de callbacks gestionado cuando el agente solo necesita recibir resultados asíncronos. AgentAddress elimina la necesidad de desplegar el servidor HTTP receptor; el runtime de tu agente sigue iniciando la ejecución original y las posteriores, mientras AgentAddress almacena todo lo que llega entre ellas.
¿Qué es un webhook con ámbito de tarea?
Un webhook con ámbito de tarea es una URL de webhook creada para una sola tarea en lugar de un endpoint de servicio de larga vida: se aprovisiona al iniciar la tarea, se entrega al servicio externo que entregará el evento y la lee la ejecución que procesa el resultado. AgentAddress lo implementa como un buzón HTTPS de solo escritura por dirección, con eventos retenidos 30 días en una cola ordenada que una ejecución posterior consulta con un token de lectura de un solo uso.
¿Qué es un buzón de webhooks?
Un buzón de webhooks es un endpoint HTTPS alojado que acepta eventos enviados por POST en nombre de una tarea y los almacena para su recuperación posterior, en lugar de reenviarlos a un servidor que tú operas. AgentAddress es un buzón de webhooks diseñado para tareas de agentes de IA: cada dirección recibe una URL de solo escritura, retención ordenada durante 30 días y sondeo basado en cursor por una ejecución posterior del agente con un token de lectura de un solo uso.