Robot WeCom

Distribuisci la tua istanza dell’account WeCom, accedi tramite scansione del codice con WeCom mobile e leggi account, contatti, conversazioni e messaggi sincronizzati localmente tramite REST API o MCP. L’istanza corrisponde a un normale account WeCom, senza necessità di server privatizzato o configurazione del dominio email aziendale. Attualmente è in Alpha. La lettura dell’account ha completato la verifica su conversazioni reali; l’invio di testi da parte dell’utente e la rilettura degli eventi hanno completato il collaudo reale; le operazioni su altri contatti, gruppi e il ripristino di nuove istanze devono ancora completare il collaudo dell’ambiente di distribuzione. L’invio di media, le risposte con citazione, i @ reali, la gestione dei membri del gruppo e le conferme di consegna non sono ancora aperti. Fare riferimento al valore restituito da /api/capabilities dell’istanza.

​

Distribuzione e accesso

Attiva il servizio nella categoria Deployment e seleziona il pacchetto di durata dell’istanza. Dopo la distribuzione, apri la pagina di gestione e usa WeCom dell’account stesso per scansionare il codice; se è necessaria una conferma sul telefono o altri passaggi di accesso, apri il desktop remoto e inserisci la password del desktop di quell’istanza. Le credenziali API e la password del desktop sono indipendenti. I dati di accesso vengono salvati sul disco dell’istanza; la ricostruzione del container conserva il disco; l’eliminazione del disco elimina la sessione locale. Ogni istanza viene addebitata separatamente e funziona in base alla durata acquistata. Le chiamate REST / MCP non vengono addebitate separatamente per messaggio; i prezzi effettivi sono soggetti alla pagina del pacchetto. Attualmente viene fatto riferimento per impostazione predefinita ai pacchetti di durata del robot WeChat; prima dell’apertura finale, la determinazione dei prezzi deve essere confermata in combinazione con le risorse di esecuzione.

​

API e MCP

Usa l’indirizzo API dell’istanza nella pagina di gestione; tutte le interfacce dell’account includono Authorization: Bearer <token API dell'istanza>. Questi percorsi appartengono a istanze dedicate e non sono un gateway API condiviso. L’indirizzo MCP è l’indirizzo dell’istanza più /mcp/, utilizzando lo stesso token Bearer. Il corpo dell’invio include target, type: "text" e text. target accetta ID conversazione, ID contatto, ID utente aziendale o nome completo univoco; usa preferibilmente gli ID; quando il nome visualizzato non può ancora identificare univocamente il destinatario, l’istanza rifiuterà l’operazione e non indovinerà il destinatario. Per i contatti senza una conversazione locale, il client aprirà prima la conversazione e invierà dopo aver verificato l’ID conversazione effettivo. L’header della richiesta Idempotency-Key è composto da 8–128 lettere, numeri o _.:-. Le richieste ripetute per la stessa operazione devono riutilizzare la stessa chiave e lo stesso corpo della richiesta. Sostituendo target con l’array targets, è possibile inviare in serie a 1–50 destinatari specificati in modo esplicito. I due non possono essere forniti contemporaneamente. Tutti i destinatari completano prima la risoluzione dell’identità e diversi alias che puntano allo stesso oggetto verranno rifiutati. Dopo il fallimento di un destinatario, gli invii successivi si interrompono; il risultato dell’attività registra per ogni elemento succeeded, failed, unknown o not_attempted; non considerare il successo parziale come successo totale. Questo flusso deve inoltre completare il collaudo reale dei contatti specificati nell’ambiente di distribuzione. Le attività possono trovarsi in queued, running, submitting, succeeded, failed, unknown o cancelled. succeeded indica che, dopo l’invio, sono stati trovati il testo esatto e l’ID messaggio del server nel record della conversazione corrispondente; delivered rimane null e non indica che l’altra parte abbia ricevuto il messaggio. unknown indica che il risultato non è chiaro; controlla la cronologia e non ripetere l’invio con una nuova chiave. L’istanza non ritrasmette automaticamente le attività interrotte. La cronologia include solo i contenuti già sincronizzati dal client e non può garantire tutta la cronologia. I messaggi non testuali possono restituire un tipo unknown; il download degli allegati non è ancora aperto. Gli eventi conservano gli ultimi 10.000 elementi; gap indica che il cursore ha superato la finestra di conservazione. La prima connessione non riproduce la vecchia cronologia come nuovi messaggi. server_accepted e server_id nella cronologia dei messaggi possono essere usati per verificare se il server ha accettato il messaggio locale; quando appare solo un record locale senza ID server, non è possibile considerare l’invio riuscito. Questi campi non indicano che il destinatario abbia ricevuto o letto il messaggio. I record degli eventi conservano lo stato al momento della generazione; per interrogare lo stato di conferma corrente, usa l’interfaccia della cronologia dei messaggi.

​

Account e credenziali

Accedi solo ad account sui quali hai l’autorizzazione a operare. Configura il token API in applicazioni affidabili; esso può accedere ai dati dell’account di quell’istanza. Non pubblicare password, codici QR o screenshot delle chat in luoghi pubblici. La sospensione dell’istanza interrompe gli eventi in tempo reale. Dopo il logout dell’account o la rimozione del dispositivo dal telefono, è necessario effettuare nuovamente l’accesso. L’input di testo corrente supporta solo una singola riga; le interruzioni di riga verranno esplicitamente rifiutate prima dell’invio. Quando il client richiede una verifica di sicurezza o un nuovo accesso, l’utente dell’account deve completarlo nel desktop remoto; l’istanza non aggirerà la verifica. Le attività dopo l’interruzione della verifica potrebbero restituire unknown; interroga prima i record dei messaggi e non ritrasmettere con una nuova chiave di idempotenza. Dopo il rilevamento di un avviso di verifica di sicurezza, del logout dell’account o di modifiche, la coda di automazione verrà sospesa in modo persistente. Dopo aver completato la verifica sul telefono, puoi continuare le attività non ancora eseguite tramite “Riprendi dopo la verifica” nella console dell’istanza; le attività già inviate ma con risultato incerto non verranno ritrasmesse. Anche il normale lavoro remoto può attivare la verifica di sicurezza di WeCom. La finestra di 24 ore senza ulteriore blocco dopo la verifica indicata nella documentazione ufficiale non significa che il rilevamento sia già stato eliminato, né significa che l’istanza possa garantire un funzionamento non presidiato a lungo termine.