Integrazioni

Stripe e n8n pronti all’uso.

COLVO parla con il tuo agente attraverso un piccolo contratto HTTP: funziona qualsiasi cosa sappia ricevere una POST e rispondere in JSON, che sia n8n, Flowise, un servizio LangChain o il tuo backend. Lato provider, la prima release copre rimborsi e disdette su Stripe.

01 — IL TUO AGENTE
Lato agente

Qualsiasi agente HTTP

COLVO invia il cliente, il contesto (abbonamenti e pagamenti), la conversazione e una chiave agente valida per quella singola esecuzione. Il tuo agente risponde con un testo e, quando vuole agire, propone un’operazione a COLVO con quella chiave. Tutto qui.

n8n

nodo webhook
  • Il trigger Webhook riceve la richiesta di COLVO
  • Il tuo flusso chiama il modello e decide
  • Il nodo HTTP Request invia la proposta a operations_url
  • Respond to Webhook restituisce reply

Flowise / LangChain

tool personalizzato
  • Esponi il flusso come endpoint HTTP
  • Dai all’agente un solo tool: proponi azione
  • Mappa il testo in uscita con un reply path
  • Stesso contratto, stessi verdetti

Il tuo servizio

qualsiasi linguaggio
  • Handler POST, JSON in ingresso, JSON in uscita
  • Header di autenticazione opzionale inviato da COLVO
  • La sonda nella pagina del progetto mostra richiesta e risposta esatte
  • Egress verificato, timeout di 30 secondi
02 — PROVIDER
Lato provider

Prima Stripe, dietro un adapter comune

Stripe simulato (COLVO Test)

Un mondo isolato per ogni tentativo, che si comporta come rimborsi, abbonamenti e fatture di Stripe, con guasti iniettabili: rifiuti, timeout, risposte perse. Per iniziare non serve un account Stripe.

  • Dati di partenza nuovi a ogni tentativo
  • Iniezione di guasti per gli scenari di errore
  • Lo stesso modello di lettura su cui verifica Guard

Stripe reale (COLVO Guard)

Collega una chiave Stripe con permessi ristretti per ogni progetto. L’agente non la vede mai: l’executor di COLVO esegue rimborsi e disdette dopo il via libera della policy, poi verifica il risultato in sola lettura.

  • refund.create, subscription.cancel (a fine periodo o subito)
  • Webhook con firma verificata in una inbox persistente
  • Chiavi di idempotenza inoltrate a Stripe

Gli altri provider useranno la stessa interfaccia di adapter e sono in roadmap dopo il pilota. Dicci quale ti serve →

03 — INTORNO
Avvisi e pipeline

Slack, email, webhook, CI

Canali di avviso

Esecuzioni in FAIL, nuovi incidenti e soglie di spesa inviati a Slack, email o qualsiasi webhook, per progetto.

/v1/alert-channels

Gate in CI

La CLI avvia una suite, attende e termina con codice diverso da zero in caso di FAIL. Funziona con GitHub Actions, GitLab CI o qualsiasi runner.

colvo run

Provider AI

OpenAI o Anthropic con la tua chiave, oppure il gateway gestito tramite withConflux. Stesso client, consumi misurati in entrambi i casi.

BYOK · gestito
≠

Collega il tuo agente in un pomeriggio.

Un endpoint, un contratto. La pagina del progetto lo interroga e ti mostra esattamente cosa ha inviato COLVO e cosa è tornato indietro.

Integrazioni — Stripe e n8n · COLVO