Come sollecito un firmatario o reinvio un link perso?

Un firmatario dice di non aver mai ricevuto l'email, o di averla persa. Non crei una nuova richiesta di firma e non ne paghi una: reinvii la stessa richiesta a quel firmatario. La busta, i suoi documenti, i suoi campi e il suo ordine di firma restano esattamente come erano, e non viene addebitato nulla (la firma è stata addebitata quando hai inviato la busta).

Reinviare a un firmatario

Prendi l'id del destinatario da una GET sulla busta (recipients[].id) e chiama:

curl -X POST https://your-host/api/v1/sign/envelopes/ENVELOPE_ID/recipients/RECIPIENT_ID/resend \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: resend-ENVELOPE_ID-RECIPIENT_ID-1"

La risposta è la busta, nella consueta forma output.sign. Il firmatario riceve di nuovo l'invito, nella lingua della busta, con un oggetto che indica che si tratta di un reinvio; la console ha lo stesso pulsante sulla riga del firmatario.

Cosa devi sapere	Dettaglio
Il link è nuovo	Il link precedente smette di funzionare nel momento in cui viene emesso quello nuovo. Un firmatario che apre la vecchia email si sente dire che il link di firma non è valido; quella da usare è la nuova email, quindi diglielo se lo avvisi per telefono. Non c'è mai più di un link valido per firmatario.
Perché non la stessa email, identica	Di ogni link conserviamo solo un hash, mai il link: nessuno, noi compresi, può rileggere un link che è stato inviato. Quindi “rimandare lo stesso messaggio” non è possibile senza conservare credenziali valide; un reinvio è proprio un link nuovo, e per il firmatario si presenta come la stessa richiesta.
A chi si può reinviare	Solo a un firmatario che può agire adesso: la busta deve essere sent o in_progress, il firmatario non deve aver firmato, rifiutato o essere stato saltato, e deve essere nel gruppo corrente (con un ordine di firma, un firmatario successivo non ha ancora un link). Altrimenti la chiamata viene rifiutata con un codice stabile (ENVELOPE_NOT_EDITABLE, RECIPIENT_ALREADY_SIGNED, SIGNING_OUT_OF_TURN, RECIPIENT_NOT_REQUIRED).
Codici e promemoria ripartono	Un firmatario bloccato da codici errati riparte da zero tentativi, e il conteggio dei promemoria automatici ricomincia.
Costo	Nessun credito per la firma. Un codice SMS che il firmatario chiede in seguito costa quanto costa un SMS.
Nuovi tentativi	Invia una Idempotency-Key: la stessa chiave restituisce la prima risposta e non manda una seconda email al firmatario.

Se l'indirizzo era sbagliato, non reinviare: sostituisci il firmatario (POST .../recipients/RECIPIENT_ID/replace) con quello giusto, il che revoca anche il vecchio link.

Promemoria automatici

Per sollecitare senza che nessuno lo chieda, imposta reminderFrequencyHours in settings — con un valore maggiore di zero, chi deve firmare in quel momento riceve un link nuovo ogni tante ore, contate da quando è stato avvisato:

"settings": { "documentId": "...", "subject": "...", "reminderFrequencyHours": 48 }

Per un promemoria immediato a tutti quelli che devono ancora firmare, usa il pulsante Invia un sollecito adesso sulla busta nella console; ignora la cadenza e riemette ogni link, come fa un reinvio. In entrambi i casi il link precedente smette di funzionare quando viene emesso quello nuovo, e nulla di tutto ciò comporta un secondo addebito.

Quando il link è scaduto, è stato revocato o sostituito

L'invito e ogni promemoria indicano per esteso giorno e ora entro cui firmare, nel fuso orario della tua organizzazione ("Ha tempo per firmare fino al 6 dicembre 2026, alle ore 11:30"). Un link che ha smesso di funzionare prima di essere usato apre una pagina che spiega il motivo — la richiesta è scaduta, è stata revocata dal mittente, oppure il firmatario è stato sostituito — nella lingua della richiesta; da lì non si può fare nulla. Quando una richiesta scade o viene revocata, ogni firmatario che era stato invitato e non aveva finito riceve anche un messaggio che lo comunica.

Finché la richiesta è ancora aperta, un reinvio (vedi sopra) dà al firmatario un link nuovo. Una volta scaduta non può essere riaperta: invia una nuova richiesta. Per dare più tempo a una richiesta, imposta expirationDate quando la crei (al massimo un anno), oppure cambia la scadenza predefinita della tua organizzazione in Impostazioni.