Vai al contenuto

API e sviluppatori

I tuoi sistemi leggono e scrivono dati in Kanesh.

API REST, server MCP e webhook firmati, con chiavi revocabili e permessi limitati. Per progetti approvati, non in modalità self-service.

Beta Disponibile per progetti approvati, non in self-service.

# Elenca i contatti con una chiave di sola letturacurl https://app.kanesh.example/api/v1/contacts \  -H "Authorization: Bearer kn_live_••••"
Dimostrazione con dati fittizi

Chiavi che fanno solo ciò che autorizzi.

API REST e schema OpenAPI per i tuoi dati, con chiavi a permessi limitati. Assegna a ogni integrazione la propria chiave e solo i permessi necessari.

  • Uno schema OpenAPI per generare un client nel linguaggio che usi.
  • Permessi di lettura, scrittura o invio, risorsa per risorsa.
  • Le chiavi sono archiviate come hash e revocabili in qualsiasi momento.
  • Invii di template idempotenti: ritentare una richiesta non invia un secondo messaggio al cliente.
  • Documentazione di riferimento nell’app dopo l’approvazione del progetto.

Illustrazione della creazione di una chiave API: riceve un nome e solo i permessi necessari, viene mostrata una volta e poi revocata. Le richieste che la usano vengono quindi rifiutate.

Dimostrazione con dati fittizi

Anche i tuoi sistemi devono parlare con i clienti.

  1. Dati isolati

    Contatti, conversazioni e ordini che il tuo ERP o BI non può leggere.

  2. Avvisi mai inviati

    Il tuo sistema rileva un evento, ma non può inviare il template WhatsApp corretto.

  3. Integrazioni fragili

    Script senza autenticazione né limiti che si interrompono appena cambia qualcosa.

Cosa puoi autorizzare una chiave a fare.

Ogni chiave riceve solo i permessi selezionati. Queste sono le risorse disponibili oggi.

Lettura

  • contacts
  • conversations
  • messages
  • orders
  • team
  • labels
  • usage
  • analytics
  • attribution
  • automations
  • campaigns
  • clicks
  • segments

Scrittura

  • contacts
  • conversations
  • labels
  • segments

Invio

  • templates:send

Gli identificatori esatti dei permessi sono nella documentazione dei progetti approvati.

Collega i tuoi strumenti di IA ai dati di Kanesh.

Un server MCP affinché i tuoi strumenti di IA possano leggere e utilizzare i dati di Kanesh con una chiave API a permessi limitati.

Beta
  • Connessione tramite HTTP in streaming e autenticazione con chiave API Bearer.
  • Compatibile con client MCP che consentono di impostare questa chiave. Non è un connettore in un clic per le app di IA rivolte ai consumatori.

Lettura

  • Contatti
  • Conversazioni
  • Messaggi
  • Ordini
  • Campagne
  • Segmenti e membri
  • Automazioni
  • Metriche
  • Attribuzioni

Azioni

  • Inviare un template WhatsApp
  • Aggiungere una nota
  • Assegnare una conversazione
  • Gestire le etichette
  • Creare o aggiornare un contatto

Eventi in uscita, messaggi in entrata.

Altre due possibilità per collegare Kanesh ai tuoi sistemi.

  • Webhook firmati

    Beta

    Webhook firmati per gli eventi principali: il tuo endpoint può verificarne la provenienza da Kanesh. L’elenco degli eventi viene condiviso con i progetti approvati.

  • Canale API personalizzato

    Beta

    Porta nella casella condivisa le conversazioni di un canale che gestisci, tramite API.

Quattro passaggi, senza registrazione self-service.

  1. 01

    Descrivi il progetto

    Cosa vuoi collegare e quali dati servono.

  2. 02

    Lo approviamo

    Se è adatto, abilitiamo l’accesso alle API per il tuo spazio di lavoro.

  3. 03

    Chiavi con permessi limitati

    Una chiave per integrazione, con i soli permessi necessari.

  4. 04

    Sviluppa e revoca

    Sviluppa usando lo schema OpenAPI. Revoca una chiave quando vuoi.

Domande degli sviluppatori

Posso ottenere subito una chiave API?
Non ancora. L’accesso è disponibile per progetti approvati: descrivi cosa vuoi realizzare e, dopo l’approvazione, riceverai chiavi con permessi limitati.
Esiste un SDK?
No. Pubblichiamo uno schema OpenAPI per generare un client nel linguaggio che usi.
Posso collegare ChatGPT o Claude?
Il server MCP funziona con i client MCP che consentono di impostare una chiave API Bearer. I connettori in un clic che richiedono un flusso di accesso non sono disponibili.
Quali eventi coprono i webhook?
I webhook sono firmati e coprono gli eventi principali. L’elenco viene condiviso con i progetti approvati anziché pubblicato qui, perché potrebbe ancora cambiare.
Cosa succede se una chiave viene esposta?
Revocala. Le richieste con chiavi revocate vengono rifiutate. Le chiavi sono archiviate come hash, quindi neppure Kanesh può mostrarti nuovamente la chiave completa.

Raccontaci cosa vuoi realizzare.

L’accesso viene concesso per progetto. Durante la diagnosi, spiegaci cosa vuoi collegare: ti diremo con franchezza se è adatto.