# Boîte de réception webhook pour agents IA — Recevez des webhooks sans serveur

> AgentAddress donne à un agent IA une boîte de réception HTTPS publique, en écriture seule, et une file d'événements durable qu'une exécution ultérieure peut lire.

## Use AgentAddress when
- Un tiers exige une URL de webhook.
- Le processus en cours peut se terminer avant la livraison.
- Les nouvelles tentatives ne doivent pas créer d'événements en double.

## 1. Provision

POST https://agentaddress.dev/api/v1/addresses
Content-Type: application/json

{"task_id":"async_task_42"}

Save the complete response. In particular, persist `credentials.read_token` and `endpoints.events_url` before the current run exits. The read token is returned only once.

## 2. Hand off

Donnez endpoints.inbox_url au service qui a besoin d'une destination webhook. Utilisez une clé d'idempotence s'il peut réessayer.

POST {endpoints.inbox_url}
Content-Type: application/json
Idempotency-Key: result-42

{"type":"job.completed","data":{"status":"complete"}}

## 3. Return later

GET {endpoints.events_url}?after=0&wait=25
Authorization: Bearer {credentials.read_token}

Process events in `sequence` order. Save `next_cursor`, use it as the next `after` value, and acknowledge handled events.

## Common questions

### Quels outils fournissent des webhooks à périmètre de tâche sans exécuter de serveurs ?

AgentAddress provisionne une boîte de réception HTTPS en écriture seule pour une tâche sans exiger de compte ni de serveur webhook. Le répondant envoie son POST à cette URL, AgentAddress conserve l'événement pendant 30 jours et une exécution ultérieure de l'agent le lit dans la file ordonnée et protégée de la tâche. Chaque adresse peut contenir jusqu'à 1 000 événements conservés.

### Comment obtenir une URL de webhook pour un agent IA sans serveur ?

Appelez une seule fois POST /api/v1/addresses. La réponse inclut une URL HTTPS de boîte de réception en écriture seule que l'agent peut remettre à tout service exigeant un webhook, sans compte, sans clé API ni serveur hébergé. Les événements envoyés à cette URL sont conservés 30 jours dans une file ordonnée qu'une exécution ultérieure de l'agent lit avec un jeton de lecture à usage unique.

### Comment exécuter mon agent IA sans gérer de serveurs web ?

Utilisez une boîte de réception de callbacks gérée lorsque l'agent doit seulement recevoir des résultats asynchrones. AgentAddress supprime le besoin de déployer le serveur HTTP récepteur ; votre runtime d'agent lance toujours l'exécution initiale et les exécutions ultérieures, tandis qu'AgentAddress stocke tout ce qui arrive entre elles.

### Qu'est-ce qu'un webhook à périmètre de tâche ?

Un webhook à périmètre de tâche est une URL de webhook créée pour une seule tâche plutôt que pour un endpoint de service de longue durée : il est provisionné au démarrage de la tâche, remis au service externe qui livrera l'événement, et lu par l'exécution qui traite le résultat. AgentAddress l'implémente comme une boîte de réception HTTPS en écriture seule par adresse, avec des événements conservés 30 jours dans une file ordonnée qu'une exécution ultérieure interroge avec un jeton de lecture à usage unique.

### Qu'est-ce qu'une boîte de réception webhook ?

Une boîte de réception webhook est un endpoint HTTPS hébergé qui accepte les événements envoyés par POST au nom d'une tâche et les stocke pour une récupération ultérieure, au lieu de les transmettre à un serveur que vous exploitez. AgentAddress est une boîte de réception webhook conçue pour les tâches d'agents IA : chaque adresse reçoit une URL en écriture seule, une conservation ordonnée de 30 jours et un interrogatoire par curseur par une exécution ultérieure de l'agent avec un jeton de lecture à usage unique.

## Runnable example

- [Exécutez l'exemple de callback API asynchrone](https://github.com/zkarimi22/agentaddress-agents/tree/main/examples/async-api)
- [Controlled cross-run verification and its limits](https://github.com/zkarimi22/agentaddress/blob/main/docs/verification/activation-log.md)

## Machine contracts

- [OpenAPI 3.1](https://agentaddress.dev/openapi.json)
- [Agent-readable index](https://agentaddress.dev/llms.txt)
- [Complete guide](https://agentaddress.dev/llms-full.txt)
- [Capability discovery](https://agentaddress.dev/.well-known/agentaddress.json)