Prova del connettore broker… meta… flusso eventi

Tenant

Invio

Conferme

Risposta

Cosa esce dal connettore

Tutto ciò che il servizio pubblica verso il tenant, mentre succede. È la metà che di solito non si vede, ed è quella che dice se un canale funziona davvero.

nessun envelope

Canali del tenant

Quello che il cliente ha collegato, comunque sia nato: a mano o dal collegamento assistito. Da valle i due percorsi sono indistinguibili — è lo stesso documento.

Aggancia questo canale

Serve quando il collegamento assistito non è praticabile: un numero WhatsApp, o una pagina di cui ci hanno passato il token invece di autenticarsi loro.

Il cliente accede con Meta e sceglie fra le sue risorse. Non digita un id, non incolla un token, non apre la console per sviluppatori. Il tenant selezionato qui sopra viaggia dentro uno stato firmato: è così che il collegamento finisce sul cliente giusto anche se a premere il bottone è lui.

La telefonata — senza telefono

Il canale voce parla con jambonz direttamente, come Telegram con la Bot API. Qui ce n'è una finta: non squilla e non suona niente, registra i verbi che le vengono comandati e li scrive fra gli eventi qui sopra come jambonz/whisper — dentro ci sono il play e il gather che riporta la mappa — e jambonz/hangup.

Da qui in poi è un canale come gli altri sei. «Nuova chiamata» mette il call_sid nel userRef e sceglie il canale voce: il pannello d'invio qui sopra fa il resto — le cinque forme del contratto e le tre conferme, senza niente di speciale. Questo pannello serve solo a far arrivare qualcosa, che sugli altri canali fai col tuo telefono.

Metti in jambonz-channel.apiBaseURL (o nella credenziale apiBaseURL del canale), e lo stesso webhookSecret qui sotto: senza, il connettore rifiuta la consegna — a voce alta, non in silenzio.

Chi chiama preme i tasti invece di parlare: il parlato vorrebbe un vendor STT dentro jambonz, e la scelta di casa è l'opposta. I tasti sono comunque il punto interessante — è lì che un bottone sopravvive con il suo id. La mappa la ripropone la finta jambonz, esattamente come farebbe quella vera.

Il canale web — con il widget vero

In basso a destra c'è il widget, quello compilato da widget/, non una finta. Aprilo e scrivi: la sessione, il messaggio e la risposta fanno lo stesso giro che farebbero sul sito di un cliente. È l'unico dei sei canali che si può provare in entrambi i sensi da questa stessa pagina — scrivi nel widget e lo vedi comparire qui accanto fra gli eventi; rispondi dal pannello di invio e lo vedi apparire nel widget.

Come provarlo

  1. apri la bolla e manda un messaggio: comparirà in Cosa esce dal connettore;
  2. copia il sessionId dall'envelope — è lo userRef del canale web;
  3. scegli web-1 qui sopra, incolla il sessionId in userRef e rispondi: la risposta arriva nella bolla.

Che strada fa

Il widget cerca un gateway: /chat-connector/web/session, /chat-connector/web/messages e una socket su /ws. Nel prodotto gliele espone rlb-gateway; qui gliele espone questo server, perché quella configurazione non è ancora applicata — ed era l'unico canale che restava fuori.