Actions HTTP et webhook
La famille http effectue des appels HTTP sortants vers des API externes (éventuellement authentifiés via une connexion stockée). La famille webhook envoie des webhooks sortants signés et écrit une réponse personnalisée vers un déclencheur webhook entrant.
HTTP — Requêtes sortantes
Six operators. L'operator générique request prend un method explicite ; les operators de verbe (get/post/put/patch/delete) sont des raccourcis et acceptent une référence connection pour les appels authentifiés.
| Operator | Props clés | Description |
|---|---|---|
request |
url, method, headers?, body?, contentType?, timeout? |
Requête générique avec une méthode explicite (templatable). |
get |
url, headers?, timeout?, connection? |
HTTP GET. |
post |
url, headers?, body?, contentType?, timeout?, connection? |
HTTP POST. |
put |
(identique à post) | HTTP PUT. |
patch |
(identique à post) | HTTP PATCH. |
delete |
url, headers?, body?, timeout?, connection? |
HTTP DELETE. |
| Prop partagée | Description |
|---|---|
url |
URL de la requête (templatable). |
headers |
Carte des en-têtes de requête (valeurs templatables, par ex. Authorization: 'Bearer $env.API_KEY'). |
body |
Corps de chaîne ou d'objet JSON. |
contentType |
json (par défaut) / form / text / xml. |
timeout |
Timeout par requête en ms. |
connection |
Nom d'une connexion stockée — injecte les informations d'identification OAuth2/clé API/basic/bearer. |
Une réponse 2xx fait réussir l'étape ; tout autre statut la fait échouer, le statut étant replié dans une catégorie d'erreur stable (HTTP 429 rate_limited, HTTP 503 upstream_error, etc.) sur laquelle les politiques de réessai peuvent s'appuyer. Le statut et le corps figurent de toute façon dans la sortie de l'étape : une étape qui doit tolérer un 404 peut être marquée continueOnError puis branchée sur {{steps.X.response.status}}.
- name: createContact
type: http
operator: post
props:
url: 'https://api.crm.example/contacts'
connection: crm-oauth
contentType: json
body: { email: '{{trigger.data.email}}', name: '{{trigger.data.name}}' }Utilisez connection plutôt que d'incorporer des secrets en ligne. Lorsqu'une connection est référencée, Sovrium attache le bon en-tête Authorization et (pour OAuth2) rafraîchit les jetons automatiquement. Définissez les connexions sous app.connections. Voir Connexions.
Webhook — Sortant et réponse
Deux operators. send déclenche un webhook sortant signé ; response écrit la réponse HTTP pour une automatisation démarrée par un déclencheur webhook.
| Operator | Props | Description |
|---|---|---|
send |
url, event, data?, secret? |
Envoie un webhook sortant avec un nom d'event et un secret HMAC optionnel. |
response |
status?, body?, headers? |
Définit la réponse HTTP renvoyée à l'appelant entrant (uniquement pour le déclencheur webhook). |
# Notify a downstream service
- name: notifyDownstream
type: webhook
operator: send
props:
url: 'https://hooks.example.com/orders'
event: order.created
data: { id: '{{trigger.data.id}}' }
secret: $env.OUTGOING_WEBHOOK_SECRET
# Reply to the inbound caller
- name: ack
type: webhook
operator: response
props: { status: 200, body: { ok: true } }Webhooks entrants vs sortants vs de table. Le déclencheur webhook reçoit du HTTP entrant (voir Déclencheurs). L'action webhook/send poste du HTTP sortant depuis une automatisation en cours d'exécution. Séparément, les webhooks de table se déclenchent automatiquement à la création/mise à jour/suppression d'enregistrement sans automatisation. L'action webhook/response ne s'applique qu'aux automatisations démarrées par un déclencheur webhook.
Pages connexes
- Connexions — informations d'identification OAuth2, clé API, basic, bearer.
- Variables d'environnement — secrets
$envutilisés dans les en-têtes. - Déclencheurs — le déclencheur webhook entrant.
- Webhooks de table — webhooks sortants automatiques sur les événements d'enregistrement.
- Actions de données et d'état — transformation des réponses HTTP.
Dernière mise à jour 11 août 2026
Cette documentation a été rédigée avec de l'IA : des erreurs ou du contenu obsolète sont donc possibles. Sovrium est en bêta. Les contributions et corrections sont les bienvenues.