Riferimento degli strumenti MCP

Il catalogo seguente utilizza le stesse definizioni inviate ai client MCP durante il rilevamento degli strumenti. Ogni pagina di riferimento aggiunge requisiti, prompt, esempi, risultati attesi e indicazioni per risolvere gli errori.

Allegati nativi ai messaggi

linkedin_message accetta attachments facoltativi. linkedin_invite_then_message accetta follow_up_attachments per il messaggio inviato dopo l’accettazione. Il testo resta obbligatorio. Fino a 5 file e 20.000.000 byte complessivi per messaggio, con 200 MB di spazio privato per area di lavoro. PDF, MP4/MOV, PNG/JPG/GIF/BMP, documenti Office e TXT/CSV/RTF vengono verificati per estensione, tipo MIME e contenuto. HTML ed eseguibili non sono supportati. Il provider può rifiutare file incompatibili con la casella selezionata.

Per un file locale, selezionalo tramite la graffetta nella posta in arrivo di SalesTouch. L’applicazione carica parti di massimo 2 MB tramite il flusso autenticato /api/linkedin/attachments, poi completa il file. Usa il suo attachment_id in un messaggio dell’agente. I client iniziano con POST /api/linkedin/attachments e account_id, filename, content_type, size_bytes; inviano parti con POST /api/linkedin/attachments/{id}, Content-Type: application/octet-stream e Upload-Offset; completano con PUT sullo stesso URL. GET restituisce stato e posizione dei byte ricevuti; DELETE rimuove un caricamento inutilizzato. Il server non apre mai percorsi locali forniti dal chiamante.

Un agente può anche fornire content_base64 (base64 canonico senza prefisso di URL dati) o una url HTTPS pubblica, con filename e content_type. Gli URL usano la porta 443; reti private e riservate, reindirizzamenti non sicuri e download oltre 15 secondi vengono rifiutati. Tutte le modalità conservano i byte privati prima della coda. L’anteprima nativa è predefinita; send_mode: "file" richiede un file scaricabile dove supportato.

queue e scheduled_for conservano i riferimenti ai file insieme all’azione. I messaggi successivi all’accettazione conservano i file fino a 90 giorni dopo l’invito programmato; i caricamenti incompleti scadono dopo 24 ore e i file consegnati dopo 7 giorni. Gli invii in attesa mantengono i file fino alla consegna. Gli esiti incerti conservano i metadati diagnostici e bloccano il reinvio automatico.

Riutilizza idempotency_key quando riprovi un messaggio con allegati. Senza chiave, destinatario, testo e file identici vengono deduplicati. Usa una nuova chiave solo per un nuovo invio intenzionale. Le risposte includono attachment_delivery_id, stato e ID dei file; i messaggi successivi li mostrano in follow_up. Consulta lo stato tramite l’endpoint autenticato GET /api/linkedin/attachment-deliveries/{id}. ATTACHMENT_SEND_UNCERTAIN richiede di controllare la conversazione prima di un altro invio. Gli errori di caricamento, autorizzazione, contenuto, dimensione e URL hanno codici espliciti.

{
  "identifier": "https://www.linkedin.com/in/example",
  "text": "Here is the brochure we discussed.",
  "attachments": [{"filename": "brochure.pdf", "content_type": "application/pdf", "url": "https://example.com/brochure.pdf"}],
  "idempotency_key": "brochure-prospect-2026-10",
  "queue": true
}

Strumenti email

Gli strumenti email richiedono il permesso email sulla connessione MCP e una casella collegata.

• email_accounts: caselle, capacità giornaliera, warmup e link di connessione quando nessuna può inviare.
• email_send: un’email personale o una risposta. Una singola email parte subito; gli invii in blocco vanno in coda.
• email_conversations: conversazioni con i lead in tutte le tue caselle, con needs_reply e ricerca nel testo completo.
• email_messages: un thread pagina per pagina, con il testo completo dei messaggi.
• email_threads: tutti i thread email e gli invii programmati di un lead.
• email_attachment: un file allegato a un’email, con il link di download; i file di testo e CSV includono il testo.

email_send accetta fino a 5 attachments (15 MB in totale): un attachment_id da email_messages per inoltrare un file ricevuto, un url HTTPS pubblico o content_base64. I file ricevuti sono conservati per 90 giorni; oltre 15 MB vengono tenuti solo nome e dimensione.