Gli agenti IA ora possono registrarsi a Hermoso e acquistare da soli i propri crediti

Hermoso ha sempre funzionato con gli agenti IA. Claude, ChatGPT, Cursor e compagnia cercano annunci, li creano e li pubblicano, ed è ciò che fa di Hermoso un agente di marketing IA e non l'ennesima dashboard. Ma c'era una cosa che un agente non poteva fare da solo: ottenere un account. Ogni account partiva da una persona davanti a una schermata di accesso. Da questa settimana gli agenti possono iniziare tramite API e, una volta dentro, pagare da soli. La registrazione agentica è partita il 26 agosto e i pagamenti automatici il 28 agosto.

Registrazione agentica

Un agente inizia con POST /v1/signup. Questo crea un checkout per un piano a pagamento. Il pagamento avviene sulla pagina di checkout di Stripe, da una persona oppure con un metodo di pagamento che l'agente può usare. Una volta pagato, l'agente rivendica l'account con POST /v1/signup/{id}/claim e riceve la propria chiave API. Da lì ha tutta la piattaforma: gli strumenti MCP, l'API REST e tutto il resto.

La registrazione per agenti passa da un piano a pagamento di proposito. Così gli account degli agenti sono sempre coperti da un pagamento reale, e il piano gratuito resta per le persone. Registrarsi dall'app funziona esattamente come sempre.

Pagamenti automatici

Prima, quando finivano i crediti, un agente doveva mandare alla sua persona un link di checkout. Ora un agente che possiede una propria credenziale di pagamento può acquistare direttamente un pacchetto di crediti:

1. Chiede un pacchetto a POST /api/billing/machine-payment.
2. Hermoso risponde con HTTP 402 Payment Required e una richiesta di pagamento.
3. L'agente autorizza il pagamento e riprova, e il pacchetto arriva sull'account.

Tutto questo gira sui pagamenti automatici di Stripe. Con le carte, un agente paga tramite un wallet pensato per gli agenti, spendendo entro limiti stabiliti da una persona, e non tiene mai in mano il numero della carta. I pacchetti sono gli stessi che le persone acquistano nell'app, agli stessi prezzi, con gli stessi crediti. I wallet possono trovare l'endpoint da soli nel nostro documento OpenAPI, e GET /api/billing/config elenca i pacchetti.

Il metodo classico funziona ancora

La maggior parte degli agenti non ha ancora una propria credenziale di pagamento, quindi anche il percorso abituale è lì. buy_credits elenca i pacchetti, addebita in un solo passaggio una carta salvata se ce n'è una, e altrimenti restituisce un link di checkout che una persona può aprire. Attiva la ricarica automatica con set_auto_reload e un saldo basso si ricarica da solo.

Cosa può fare un agente già dal primo giorno

Una volta che un agente ha la sua chiave, dispone dello stesso Hermoso che una persona ha nell'app:

• Configura il brand partendo da un sito web, una descrizione o un handle social.
• Ricerca gli annunci che già funzionano sul mercato e i creator che le persone seguono.
• Pianifica e genera annunci finiti, di immagine e video.
• Pubblica e programma sui canali che le sue persone collegano, e legge come sono andati i post.

Collegare un account social o un account pubblicitario avviene ancora sulla schermata di accesso di quella piattaforma, quindi una persona clicca una volta per quella parte.

I controlli restano alle persone

Le ricariche con un clic usano una carta salvata e richiedono i diritti di amministratore di fatturazione. Gli abbonamenti sono gestiti da una persona in Workspace, Billing. E un pagamento automatico può acquistare solo i pacchetti di crediti che Hermoso elenca, ai prezzi indicati, quindi un agente può continuare a lavorare senza poter cambiare ciò che paga.

Perché l'abbiamo costruito

Gran parte del lavoro di marketing sarà svolto da agenti che lavorano 24 ore su 24: ricerche durante la notte, annunci nuovi la mattina, post che escono in programma. Questi agenti devono poter partire, andare avanti e pagare da soli senza aspettare che qualcuno clicchi un pulsante. Ora possono farlo.

Try it

Gli endpoint sono nel riferimento API, e collegare un agente a Hermoso richiede un paio di minuti dalla pagina MCP.

Domande frequenti

Un agente IA può creare un account Hermoso?

Sì. POST /v1/signup crea un checkout per un piano a pagamento. Dopo il pagamento sulla pagina di checkout di Stripe, l'agente rivendica l'account con POST /v1/signup/{id}/claim e riceve la propria chiave API.

Perché la registrazione per agenti richiede un piano a pagamento?

Così gli account degli agenti sono sempre coperti da un pagamento reale. Il piano gratuito resta per le persone che si registrano dall'app.

Come fa un agente ad acquistare crediti senza una persona?

Con una propria credenziale di pagamento, l'agente richiede un pacchetto a POST /api/billing/machine-payment, riceve una richiesta HTTP 402, autorizza il pagamento e riprova. Il pacchetto viene aggiunto all'account.

Gli agenti pagano prezzi diversi?

No. Gli agenti acquistano gli stessi pacchetti di crediti, agli stessi prezzi delle persone nell'app.