Sviluppatori: webhook e bot cifrati e gratuiti

Bot webhook

Un webhook con una finestra di chat all'altra estremità

Un bot è un'identità che il tuo telefono crea e possiede. I tuoi sistemi gli inviano messaggi via HTTPS e chi è iscritto a quel bot riceve ciò che ha da dire.

Creato nell'app, in pochi secondi

Apri la scheda Bot, tocca Nuovo e dagli il nome del sistema che invierà i messaggi. Ricevi subito un URL webhook e un token. Niente da registrare, nessuno a cui chiedere il permesso.

Una POST è tutta l'API

Invia JSON con un campo text e un token bearer. Tutto ciò che parla HTTP può usarlo: curl, uno step di CI, un Cloudflare Worker, un'azione di monitoraggio, uno script.

Chi riceve scansiona, non si registra

Le persone iniziano a ricevere un bot scansionando il suo codice QR nell'app e possono smettere quando vogliono. Nessun link di invito da inoltrare, nessun elenco di iscritti da consegnare.

Solo in ricezione, di proposito

Nella chat di un bot il campo di scrittura resta nascosto. Un bot può avvisarti e non può mai diventare un modo per rispondere alla tua infrastruttura.

Guida rapida

Da zero a un avviso consegnato in circa un minuto

Tre passaggi, nessuno dei quali prevede un modulo di registrazione o una coda di approvazione.

Crea il bot

Nell'app apri la scheda Bot e tocca Nuovo. Dagli il nome del sistema che invierà i messaggi: build-server, uptime, pagamenti.

Conserva il token

Viene mostrato una sola volta e conservato solo come hash, quindi mettilo subito nel tuo gestore di segreti. Se dovesse trapelare, rigeneralo dalla schermata di dettaglio del bot: il vecchio smette di funzionare all'istante.

Condividi il QR, poi invia

Chi deve ricevere gli avvisi scansiona il codice del bot nell'app. Da quel momento ogni POST lo raggiunge in circa un secondo, con una notifica che mostra il nome del bot e nient'altro.

Richiesta

curl -X POST https://api.talkridge.com/hook/YOUR_BOT_ID \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":"Deploy 4.2.1 finished, 0 errors.","source":"ci"}'

Risposta

{ "ok": true, "v": "t1", "delivered": 3 }

delivered è il numero di dispositivi iscritti per cui il messaggio è stato sigillato. Un bot senza iscritti risponde zero invece di dare errore, così un primo deploy non si rompe per causa sua.

Riferimento

L'intera API, in una sola schermata

Nessun SDK da installare, nessun client con versioni da tenere aggiornato. Questa è tutta la superficie.

Endpoint

POST https://api.talkridge.com/hook/{bot_id}, solo su HTTPS. L'id del bot fa parte dell'URL webhook che l'app ti mostra.

Autenticazione

Authorization: Bearer {token}. Il token viene confrontato a tempo costante con un hash memorizzato e può essere rigenerato dall'app in qualsiasi momento.

Corpo

JSON con text (obbligatorio) e source (facoltativo). Se presente, source viene anteposto al messaggio, così un solo bot può trasportare più sistemi e si capisce comunque da quale arrivano.

Successo

200 con ok: true e delivered: N, dove N è il numero di dispositivi iscritti per cui il relay ha sigillato una copia.

Errori

JSON semplice con ok: false e una ragione breve. 400 se manca text, 401 per un token errato, 404 per un bot inesistente, 429 se superi il limite di frequenza.

Limiti

4.000 caratteri per messaggio, 60 invii al minuto per bot, fino a 20 bot per proprietario. Il testo più lungo viene troncato invece che rifiutato.

Ciò a cui non ti stai iscrivendo

Le parti che gli altri endpoint webhook lasciano fuori

Collegare gli avvisi di solito significa aggiungere i propri sistemi a una piattaforma di chat che fattura per utente e conserva ogni messaggio che ha mai trasportato. Qui non succede né l'una né l'altra cosa.

Gratuito, senza utenti da contare

Nessun piano per team, nessun prezzo per utente, nessuna console di amministrazione. Un bot appartiene al telefono che lo ha creato e può essere trasferito a un'altra identità se quel telefono viene sostituito.

Nessun archivio nel cloud

Il relay conserva ogni busta sigillata solo finché il dispositivo iscritto non la ritira, poi la cancella. Il flusso dei tuoi avvisi non diventa mai uno storico consultabile sui server di qualcun altro.

Notifiche senza contenuto

Le notifiche push non trasportano il corpo del messaggio. La schermata di blocco dice che è arrivato qualcosa, mai che cosa diceva.

Viaggia con l'app

Gli avvisi arrivano nella stessa app delle conversazioni private, su iOS e Android, dietro lo stesso blocco del dispositivo. Chi è reperibile non deve installare un secondo messenger.

Risposta chiara

Dove passa davvero il confine della fiducia

Tra due persone TalkRidge non possiede alcuna chiave in grado di aprire un messaggio: le chiavi nascono sui due telefoni e si scambiano scansionando. Chi invia un webhook è un server, non un telefono, quindi la chiave di identità di un bot è custodita dal relay, che sigilla ogni consegna con la chiave del dispositivo iscritto per conto del bot.

Quindi un flusso di avvisi è protetto in transito, sigillato quando è conservato e leggibile sul dispositivo iscritto, ma non è il modello a conoscenza zero di una chat privata. Preferiamo scriverlo chiaramente piuttosto che lasciarti supporre qualcosa di più forte. Manda i messaggi operativi attraverso un bot e tieni il materiale più sensibile in una conversazione.

Che cosa vede il relay

Il testo che un bot invia, perché ne sigilla una copia per ogni iscritto.

Gli identificatori delle caselle a cui consegna, che non contengono nome, numero di telefono o indirizzo email.

Assolutamente nulla delle tue conversazioni private, che con i bot non hanno alcun rapporto.

La crittografia di TalkRidge è costruita esclusivamente con primitive crittografiche open source verificate e non modificate, e il progetto del protocollo è documentato apertamente. Le applicazioni non hanno ancora superato un audit di sicurezza esterno indipendente — lo diciamo chiaramente invece di prenderci una fiducia non nostra, e una revisione indipendente è in programma.

Dove si inserisce

Che cosa i team collegano già a un bot

Tutto ciò che avresti collegato a un webhook di chat, senza il workspace, senza la fattura e senza la politica di conservazione.

Notifiche di deploy e CI, senza far entrare un server di build nel workspace di chat aziendale

Allarmi di uptime e reperibilità che raggiungono un telefono anche a portatile chiuso

Eventi di pagamento, frode e ordini per un piccolo team che preferisce non farli passare da una piattaforma pubblica

Invii dei moduli di un sito, che è esattamente il modo in cui viene recapitato il modulo di contatto di questo sito

Output degli strumenti di sicurezza, tenuto lontano dai fornitori e dalla rete che stanno monitorando

Qualsiasi cosa un tuo cliente debba sapere, senza chiedergli di installare l'ennesima app con account

Parlaci della tua integrazione →

Webhook che arrivano in una casella cifrata

Un webhook con una finestra di chat all'altra estremità

Da zero a un avviso consegnato in circa un minuto

L'intera API, in una sola schermata

Le parti che gli altri endpoint webhook lasciano fuori

Dove passa davvero il confine della fiducia

Che cosa i team collegano già a un bot

Domande? Parla con una persona.

Sede centrale

Scrivici