Vai al contenuto

Pronto a creare con AnyBot?

Documentazione AnyBot
Integrazioni

Wise

Collega Wise con un token API di sola lettura, così il tuo agente può fornire preventivi sui tassi e leggere saldi, destinatari e transazioni, non sposta mai denaro.

Collega Wise con un solo token API di sola lettura e il tuo agente ottiene sette strumenti finanziari: cinque strumenti owner-only che leggono i tuoi profili, saldi, destinatari e cronologia delle transazioni, più due strumenti public-safe che forniscono un tasso di cambio in tempo reale e stimano il costo di un trasferimento. Una sola regola definisce l'intera integrazione: qui Wise legge e fornisce preventivi, non sposta mai denaro.

Connessione

  1. In Wise, crea un token API (Settings → API tokens) per l'ambiente che usi, production o sandbox.
  2. Apri Integrazioni in AnyBot e scegli Wise.
  3. Incolla il token, scegli l'Ambiente corrispondente e connetti. AnyBot convalida il token rispetto ai tuoi profili Wise e cattura il tuo profilo principale.
la finestra di dialogo di connessione a Wise con il campo del token API e il selettore dell'ambiente

Il dettaglio decisivo: l'Ambiente deve corrispondere a dove è stato emesso il token. Un token production selezionato come sandbox (o viceversa) non supera la convalida, AnyBot sonda GET /v2/profiles alla connessione e rifiuta subito un token errato o di ambiente sbagliato. Il token è statico: non c'è OAuth né aggiornamento automatico, quindi se lo revochi o lo ruoti in Wise, riconnettiti qui.

Facoltativamente, imposta una Valuta predefinita (un codice di 3 lettere) sull'integrazione, precompila il filtro valuta quando l'agente cerca i destinatari.

Cosa può fare l'agente

StrumentoAccessoTipoCosa fa
wise_list_profilesSolo proprietarioReadElenca i profili personali e aziendali sull'account connesso con l'id e il tipo di ciascun profilo.
wise_list_balancesSolo proprietarioReadElenca i saldi multi-valuta in un profilo con l'id, la valuta e l'importo disponibile di ciascun saldo.
wise_get_balanceSolo proprietarioReadLegge un saldo tramite id, valuta, importi disponibili e riservati.
wise_list_recipientsSolo proprietarioReadElenca gli account destinatari (payout) salvati su un profilo, facoltativamente filtrati per valuta.
wise_list_transactionsSolo proprietarioReadElenca l'attività recente dell'account, trasferimenti, spese con carta, conversioni, commissioni, con stato e paginazione.
wise_get_ratePubblico sicuroReadRestituisce il tasso di cambio Wise mid-market in tempo reale tra due valute.
wise_create_quotePubblico sicuroReadStima il tasso, le commissioni e gli importi di un trasferimento. Una stima non autenticata, non sposta mai denaro.

Public-safe vs owner-only

I due strumenti sui tassi sono public-safe: un visitatore del sito può chiedere "quanto vale EUR in USD?" o "quanto costerebbe inviare 500 euro?" e l'agente risponde. I cinque strumenti sull'account, profili, saldi, destinatari e transazioni, sono owner-only e contrassegnati come sensibili, quindi le loro chiamate restano nascoste dal flusso della chat e un visitatore non può mai raggiungere il tuo account Wise tramite un agente. Metti gli strumenti sull'account su un agente interno con cui parla il tuo team, non su un bot rivolto ai clienti.

Esempio pratico

Un visitatore sulla tua pagina dei prezzi chiede: "Sono nel Regno Unito, a quanto corrisponderebbero 2.000 £ in dollari dopo la vostra commissione?" L'agente esegue wise_get_rate per il tasso GBP→USD in tempo reale, poi wise_create_quote per includere la commissione di Wise, e risponde con gli importi reali di invio/ricezione, nessun pagamento viene creato e nessun login viene toccato. Il tuo team finanziario, su un agente interno, può inoltre chiedere "qual è il nostro saldo in EUR?" e ottenere in risposta wise_list_balances.

Limiti e onestà

  • Solo lettura e preventivi. Ogni strumento è di sola lettura. Non esiste alcuno strumento di scrittura, niente per spostare denaro, creare un trasferimento o modificare un destinatario.
  • Token statico. Niente OAuth, niente aggiornamento automatico. Ruota o revoca in Wise, poi riconnettiti.
  • Le transazioni possono richiedere approvazione. Per i token personali, Wise può proteggere la cronologia delle transazioni dietro un'autenticazione forte del cliente a due fattori; wise_list_transactions degrada in modo controllato anziché generare un errore.

Risoluzione dei problemi

  • Connessione rifiutata in fase di configurazione, il token non è valido, è scaduto, oppure l'Ambiente non corrisponde. Riemetti in Wise e riconnettiti, facendo corrispondere sandbox e production.
  • Nessuna transazione restituita, Wise ha richiesto un'approvazione 2FA (SCA) che il token API non può soddisfare. Questo è un limite di Wise sui token personali, non un bug.
  • Un visitatore non può vedere i saldi, è previsto dalla progettazione. Gli strumenti sull'account sono owner-only; solo i tassi e i preventivi sono rivolti ai visitatori.

FAQ

L'agente può inviare denaro o pagare qualcuno? No. Wise è solo lettura e preventivi, non esiste alcuno strumento di trasferimento o payout.

Un visitatore del sito può vedere i miei saldi? No. Saldi, destinatari, transazioni e profili sono tutti owner-only.

Account personale o aziendale? Funziona con entrambi i token. Quando esistono entrambi i tipi di profilo, il profilo aziendale è preferito come predefinito.

Prossimi passi