IFrame ή Ενσωματωμένη Υπογραφή

Ενσωματώστε/iframe τη σελίδα υπογραφής στην δική σας εφαρμογή.

Ενημέρωση - Επεξεργασία JS συστατικού και υπογραφή σύντομα. Επικοινωνήστε μαζί μας.

Άμεσοι σύνδεσμοι

Αν χρειάζεστε μια απλή ανοιχτή σελίδα που δεν απαιτεί προσαρμογή, όπου ο καθένας μπορεί να πάει και να υπογράψει ένα έγγραφο (και προαιρετικά να επιβεβαιώσει το email του στη συνέχεια), δοκιμάστε το Legalesign Link. Μπορείτε να δημιουργήσετε αυτά στην web εφαρμογή χωρίς κώδικα. Είναι και ενσωματώσιμα. Παραδείγματα συνδέσμων μπορεί να είναι εγγραφή σε εκδήλωση, φύλλα χρόνου, απελευθέρωση ευθύνης. Μάθετε περισσότερα για το Legalesign Link (ενσωματώσιμες σελίδες υπογραφής).

API

Αν χρειάζεται να προσαρμόσετε το έγγραφο ή απαιτείτε περισσότερη λειτουργικότητα, τότε χρησιμοποιήστε το API.

Περιορισμοί

Συσκευές

Αυτό αφορά έγγραφα βασισμένα σε PDF (όχι έγγραφα τύπου text/html).

• τα desktop περιβάλλοντα λειτουργούν καλά
• τα mobile περιβάλλοντα λειτουργούν για απλά έγγραφα (π.χ. μια υπογραφή, όχι πολύπλοκες φόρμες)
• τα mobile περιβάλλοντα με πολύπλοκη φόρμα μπορεί να μην λειτουργήσουν καλά (ειδικά για iphones) και προτείνουμε να μεταφέρετε τον χρήστη σε νέο παράθυρο browser (μπορείτε να το αποκρύψετε αφαιρώντας περιττό περιεχόμενο της σελίδας υπογραφής και με redirect, δείτε παρακάτω).

Παρότι η τελευταία επιλογή δεν προσφέρει απρόσκοπτη εμπειρία χρήστη, θα εξασφαλίσει τηρημένη εμπειρία για τους χρήστες σας. Όσο γνωρίζουμε, δεν είναι δυνατόν να έχουμε βεβαιότητα για το μέγεθος της συσκευής του χρήστη από μέσα σε ένα iframe παράθυρο (σε μερικά ή όλα τα iphones), κάτι που καθιστά την καθαρή πλοήγηση σε μία πολύπλοκη φόρμα αναξιόπιστη.

Πρότυπο υπογραφής

Μια δεύτερη προειδοποίηση, χωρίς κάποια προγραμματισμένη διαδικασία ίσως να μην πετύχετε το ‘προηγμένο’ πρότυπο ηλεκτρονικής υπογραφής.

Κύρια στοιχεία του προτύπου περιλαμβάνουν

• ο υπογράφων πρέπει να έχει αποκλειστικό έλεγχο στη διαδικασία υπογραφής και
• πρέπει να είναι μοναδικά αναγνωρίσιμος.

Λαμβάνοντας εσείς το σύνδεσμο υπογραφής, μπορείτε πλέον να υπογράψετε το έγγραφο εσείς· χάνεται ο αποκλειστικός έλεγχος.

Μια λύση μπορεί να είναι να προσθέσετε επικύρωση μέσω SMS για τον παραλήπτη σας. Η παραλαβή αυτού του μηνύματος SMS θα είναι υπό αποκλειστικό έλεγχο του παραλήπτη σας και θα τον αναγνωρίζει μοναδικά.

Θα χρειαστεί να προγραμματίσετε ποια μέτρα ελέγχου θα είναι σε ισχύ ώστε να διασφαλίσετε ότι ο υπογράφων είναι αναγνωρίσιμος και έχει αποκλειστικό έλεγχο από την πλευρά σας για να ξανακερδίσετε αυτό το ‘προηγμένο’ πρότυπο. Μάθετε περισσότερα για τον νόμο για τις ηλεκτρονικές υπογραφές.

Πώς να δημιουργήσετε έναν ενσωματώσιμο σύνδεσμο υπογραφής

Έχετε ήδη ακολουθήσει το ταχύρρυθμο σεμινάριο και δημιουργήσει/στείλει με επιτυχία ένα έγγραφο για υπογραφή.

1. Απλώς προσθέστε το ακόλουθο χαρακτηριστικό στο αίτημα POST που δημιουργεί/στέλνει ένα έγγραφο (π.χ. /api/v1/document/):

{return_signer_links: true}

2. Διαβάστε το ΣΩΜΑ της απάντησης και θα βρείτε ένα αντικείμενο JSON που περιέχει τους συνδέσμους υπογραφής για κάθε παραλήπτη του εγγράφου σας.

3. Βάλτε τον σύνδεσμο υπογραφής μέσα σε ένα στοιχείο iframe.

Άλλα χρήσιμα χαρακτηριστικά

• Για να απενεργοποιήσετε όλα τα email της Legalesign, στο POST προς το /api/v1/document/ θέστε αυτή τη μεταβλητή: {do_email: false}.

• Για να ανακατευθύνετε τον χρήστη αμέσως μετά την υπογραφή, προσθέστε αυτό το χαρακτηριστικό: {redirect: yourUrl } (βλ. παρακάτω).

• Για να αφαιρέσετε περιττά στοιχεία από τη σελίδα υπογραφής, προσθέστε αυτό το querystring στον σύνδεσμο υπογραφής: &hidenav=1&hidetext=1

Εξετάστε όλα τα χαρακτηριστικά αποστολής εγγράφου εδώ: Αποστολή Εγγράφου με κλήση API

Παράγοντας Safari

Αν περιμένετε χρήστες Safari, μπορεί να χρειαστεί να προσθέσετε μια 'διόρθωση' με ένα μικρό κομμάτι javascript.

Οι προεπιλεγμένες ρυθμίσεις ασφαλείας του Safari απαγορεύουν τα cookies σε iframe. Αν θέλετε να το χειριστείτε χωρίς διαταραχή χρήστη, θα χρειαστεί α) να μας στείλετε το root domain σας, και β) να εκτελέσετε javascript πριν φορτώσει το iframe - κάντε κλικ εδώ για τον κώδικα (συγγνώμη για το jquery, μπορείτε να τον προσαρμόσετε όπως χρειάζεται). Μέσα στο js θα χρειαστεί να προσθέσετε κάποιες παραμέτρους στην URL που ερωτάται. Αν δεν είναι σαφές από το παράδειγμα κώδικα, επικοινωνήστε μαζί μας για βοήθεια.

Ο Safari έχει καταστήσει όλο και πιο δύσκολη τη χρήση του iframe.

Αν θέλετε να εξασφαλίσετε ότι το iframe δουλεύει στο Safari, θα χρειαστεί να χρησιμοποιήσετε το νέο χαρακτηριστικό CNAME μας. Αυτό θα βάλει τις σελίδες υπογραφής σε υποτομέα του κύριου domain σας. Αυτό το χαρακτηριστικό είναι ακόμα σε beta, επικοινωνήστε μαζί μας αν θέλετε να το χρησιμοποιήσετε.

Η καλύτερη εναλλακτική είναι να μεταφέρετε τους χρήστες σε νέο παράθυρο browser, αφού έχετε ορίσει μια διεύθυνση URL ανακατεύθυνσης μετά την υπογραφή στο έγγραφο για να τους φέρετε πίσω μετά την ολοκλήρωση (βλ. παρακάτω).

Σήματα μετά την ολοκλήρωση

Υπάρχουν δύο τρόποι να ελέγξετε μετά από μια υπογραφή.

• Ορίστε μια διεύθυνση URL ανακατεύθυνσης στο έγγραφό σας όταν το δημιουργείτε. Το Legalesign θα ανακατευθύνει τον χρήστη στη διεύθυνσή σας μετά την ολοκλήρωση του εγγράφου, ή
• χρησιμοποιήστε τη δυνατότητα javascript postMessage.

διεύθυνση ανακατεύθυνσης

Απλώς προσθέστε τη διεύθυνση ανακατεύθυνσης στο χαρακτηριστικό 'redirect' του αιτήματος POST που δημιουργεί το έγγραφο (/api/v1/document/).

Επειδή το redirect είναι ανά έγγραφο (όχι ανά χρήστη), το Legalesign θα προσθέσει query string στη διεύθυνση ανακατεύθυνσής σας που μπορείτε να χρησιμοποιήσετε για να συλλέξετε πληροφορίες σχετικά με το έγγραφο και την κατάσταση των υπογραφόντων:

[η διεύθυνσή σας]?signer=[signer UID]&doc=[doc UID]&group=[group UID]&signer_state=[signer status]&doc_state=[doc state]

Κάντε κλικ σε αυτούς τους συνδέσμους για να δείτε τον πίνακα αναφοράς για την κατάσταση εγγράφου και την κατάσταση υπογράφοντος.

postMessage

Ένα postMessage είναι ένα μήνυμα που στέλνεται μέσω javascript και μπορεί να ληφθεί στο γονικό πλαίσιο (parent frame). Μπορείτε στη συνέχεια να χρησιμοποιήσετε αυτά τα μηνύματα για να εκτελέσετε ανακατευθύνσεις ή να ξαναφορτώσετε τη σελίδα όπως χρειάζεται.

Μετά την υπογραφή θα λάβετε αμέσως ένα από τρία πιθανά javascript postMessage μηνύματα: 'waiting’, 'signed’, 'rejected’.

Αν το έγγραφο έχει υπογραφεί και αφήσετε τη διαδικασία υπογραφής να συνεχιστεί και να εμφανιστεί η σελίδα λήψης (download) στο iframe σας, θα λάβετε επίσης το μήνυμα 'download’ αν πατηθεί το κουμπί λήψης του εγγράφου.

Θα λάβετε το μήνυμα 'waiting’ αν έχετε περισσότερους από 1 υπογράφοντες και το έγγραφο χρειάζεται ακόμα υπογραφές από άλλους.

Για περισσότερες πληροφορίες για το postMessage δείτε: https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage.

Αν σκοπεύετε να κάνετε ανακατεύθυνση του υπογράφοντα, να γνωρίζετε ότι μπορεί να δει σύντομα να αποτυπώνεται μια νέα σελίδα (είτε η σελίδα 'download' είτε η σελίδα 'waiting for others') πριν εφαρμοστεί η ανακατεύθυνση μέσω postMessage.

Επόμενο.

Μετά από μια υπογραφή μπορείτε να κατεβάσετε το τελικό έγγραφο PDF. Συνιστούμε να χρησιμοποιήσετε webhooks για αυτό. Μάθετε περισσότερα για τα webhooks. Δείτε την τεκμηρίωση για την κλήση API για λήψη τελικού PDF. Αποφύγετε την άμεση λήψη αμέσως μετά από ένα γεγονός υπογραφής (χρησιμοποιώντας τα σήματα μετά την υπογραφή που περιγράφονται παραπάνω), γιατί το τελικό PDF μπορεί να μην είναι έτοιμο. Πιο αξιόπιστα, ακούστε το webhook όπου το αντικείμενο είναι 'document' και το γεγονός είναι 'finalPdfCreated'.