Skip to main content
All CollectionsCustom integrations
Dokobit integration in Journeys using Webhooks
Dokobit integration in Journeys using Webhooks

Settings for the Dokobit endpoints and webhook in Journeys

Helga Kolbrún Magnúsdóttir avatar
Written by Helga Kolbrún Magnúsdóttir
Updated over a week ago

Related articles

You can send a document to e-signing via Dokobit in Journeys, using Dokobit Portal API.

You first need your access token, you can that in the Dokobit API Dashboard. Go to "Usage statistics" → "Expand your account" → "API access token".

In Journeys under integrations you can create a new integration, name it "Dokobit" and add a logo.

Authentication:

Authentication type is none

Create an endpoint to test the token

Click on "Add Endpoint" button and choose "Api"

You can test the token by creating an endpoint called "Testing the token".

Now setup like this and past the token inside brackets in the url

Expand the ""Request values" and paste you access token in the Test request

Press Save and then Test

Then you should get a response like this if all everything is ok

Send document to signing

Now let's create an endpoint which we can call "Send document to signing"

Choose "Add Endpoint" - "API"

Where the last part (d6kclsj394hk8) is your access token

And the JSON should be like this:

{
"name": "Contract",
"type": "pdf",
"files": [
{
"name": "Contract.pdf",
"digest": "53eb2b7c370815d028b717b90876bbcd76140d3897e399f46329d014ca383c23",
"content": "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MjIgMCA2NjcgNjExIDAgMCAwIDUwMCAwIDAgOTQ0IDcyMiAwIDYxMSAwIDAgNTU2IDAgMCAwIDAgMCAwIDAgMCAwIDAgMCAwIDAgNTAwIDU1NiA0NDQgNTU2IDQ0NCAzMzMgMCA1NTYgMjc4IDAgNTU2IDI3OCA4MzMgNTU2IDUwMCA1NTYgMCA0NDQgMzg5IDMzMyAwIDAgNzIyIDAgNTAwIF0KL0VuY29kaW5nIC9XaW5BbnNpRW5jb2RpbmcgL1N1YnR5cGUgL1R5cGUxID4+CmVuZG9iago5IDAgb2JqCjw8L1R5cGUgL0ZvbnREZXNjcmlwdG9yIC9Gb250TmFtZSAvT0tHQkZHK1RpbWVzLVJvbWFuIC9Gb250QkJveCBbLTcwIC0yMTggNzc1IDY4MyBdCi9GbGFncyAzMiAvQXNjZW50IDY4MyAvQ2FwSGVpZ2h0IDY3NiAvRGVzY2VudCAtMjE4IC9JdGFsaWNBbmdsZSAwIC9TdGVtViAxMTYgL01pc3NpbmdXaWR0aCAyNTAgL1hIZWlnaHQgNDYwIC9DaGFyU2V0ICgvQS9DL04vTy9SL1QvYS9iL2JyYWNlbGVmdC9icmFjZXJpZ2h0L2MvZC9lL2YvaC9pL2ovay9sL20vbi9vL3Avci9zL3NwYWNlL3QvdW5kZXJzY29yZS93L3kpL0ZvbnRGaWxlMyAxMSAwIFIKPj4KZW5kb2JqCjEwIDAgb2JqCjw8L1R5cGUgL0ZvbnREZXNjcmlwdG9yIC9Gb250TmFtZSAvQUhEUVlGK1RpbWVzLUJvbGQgL0ZvbnRCQm94IFswIC0yMDUgOTIxIDY5MiBdCi9GbGFncyAzMiAvQXNjZW50IDY5MiAvQ2FwSGVpZ2h0IDY5MiAvRGVzY2VudCAtMjA1IC9JdGFsaWNBbmdsZSAwIC9TdGVtViAxMzggL01pc3NpbmdXaWR0aCAyNTAgL1hIZWlnaHQgNDczIC9DaGFyU2V0ICgvQS9DL0UvRi9KL00vTi9QL1MvYS9iL2MvY29sb24vZC9lL2YvaC9pL2svbC9tL24vby9wL3Ivcy9zcGFjZS90L3cveSkvRm9udEZpbGUzIDEyIDAgUgo+PgplbmRvYmoKMTEgMCBvYmoKPDwvRmlsdGVyIC9GbGF0ZURlY29kZSAvU3VidHlwZSAvVHlwZTFD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GA045LFzoRmqqqx6NlTLMsrMjqQKtrN+djvnEWznslOzUZAskSS/ez5rfGLg/PiEZCBJBNPz2bOUxPNZE+MDA2PjgbPQik5G3AqpDp5/IQiD/ZaQEBDaQn5GUf8LxpiVMgplbmRzdHJlYW0KZW5kb2JqCjIgMCBvYmoKPDwKL1Byb2NTZXQgWy9QREYgL1RleHQgL0ltYWdlQiAvSW1hZ2VDIC9JbWFnZUldCi9Gb250IDw8Cj4+Ci9YT2JqZWN0IDw8Ci9UUEwxIDUgMCBSCj4+Cj4+CmVuZG9iagoxMyAwIG9iago8PAovQ3JlYXRvciAoT25saW5lMlBERi5jb20pCi9Qcm9kdWNlciAoT25saW5lMlBERi5jb20pCi9DcmVhdGlvbkRhdGUgKEQ6MjAyNDA0MTgxMTU0MzkrMDInMDAnKQo+PgplbmRvYmoKMTQgMCBvYmoKPDwKL1R5cGUgL0NhdGFsb2cKL1BhZ2VzIDEgMCBSCi9PcGVuQWN0aW9uIFszIDAgUiAvRml0SCBudWxsXQovUGFnZUxheW91dCAvT25lQ29sdW1uCj4+CmVuZG9iagp4cmVmCjAgMTUKMDAwMDAwMDAwMCA2NTUzNSBmIAowMDAwMDAwMjU3IDAwMDAwIG4gCjAwMDAwMTAwMTUgMDAwMDAgbiAKMDAwMDAwMDAwOSAwMDAwMCBuIAowMDAwMDAwMTE3IDAwMDAwIG4gCjAwMDAwMDAzNDQgMDAwMDAgbiAKMDAwMDAwMjA1OCAwMDAwMCBuIAowMDAwMDAyMDk4IDAwMDAwIG4gCjAwMDAwMDI1MTIgMDAwMDAgbiAKMDAwMDAwMjkxOCAwMDAwMCBuIAowMDAwMDAzMjQ3IDAwMDAwIG4gCjAwMDAwMDM1NTIgMDAwMDAgbiAKMDAwMDAwNjgyMiAwMDAwMCBuIAowMDAwMDEwMTIxIDAwMDAwIG4gCjAwMDAwMTAyMzYgMDAwMDAgbiAKdHJhaWxlcgo8PAovU2l6ZSAxNQovUm9vdCAxNCAwIFIKL0luZm8gMTMgMCBSCi9JRCBbPDNCM0YwMjc4RjU4Mzk2NjhENDhCODUwMjZGNjM3QkNDPjwzQjNGMDI3OEY1ODM5NjY4RDQ4Qjg1MDI2RjYzN0JDQz5dCj4+CnN0YXJ0eHJlZgoxMDM0MAolJUVPRgo="
}
],
"signers": [
{
"name": "John Smith",
"email": "james@demo.com",
"phone": "+3546660000"
}
],
"postback_url": "http://test.com",
"require_account": "0"
}

Open the Request values and edit the following information

  • signers_name -> your name

  • signers_email -> your email

  • signers_phone -> your phone

Press "Add Endpoint" button at the bottom of page to save this info.

Expand now this endpoint "Send document to signing" and press "Test" for Request values.

The response you get should be like this

If this is successful you just need to change the type of pdfDocument to file and save:

Copy the token on the third line, the one in green here in the screenshot above, you need to use it in the endpoint to get the document. You can press "Test" again to be able to copy the token from the response pop up window.

Webhooks

We use webhooks to listen to when the document has been signed, here are more information about webhooks.

Create a new endpoint but now select "Webhook"

Turn of the toggle for "Subscribe using external url"

This is the text you copy into the "Payload values"

{
"file": "https://app.dokobit.com/api/signing/421b3e7148eb5448de5722b88892f261d0e16031/download",
"name": "Contract",
"type": "pdf",
"files": [
{
"url": "https://app.dokobit.com/api/signing/58430719ef14ca6ef2645df77745354b823c43e2e493854e80a1e6ff599a1602/file-download",
"name": "Contract.pdf",
"type": null,
"mime_type": "application/pdf"
}
],
"token": "421b3e7148eb5448de5722b88892f261d0e16031",
"action": "signer_signed",
"status": "completed",
"signers": [
{
"code": "",
"type": "signer",
"email": "",
"token": "",
"status": "signed",
"country": "is",
"last_name": "",
"signature": {
"seal": false,
"level": "PAdES-LT",
"errors": [],
"timemark": [],
"warnings": [],
"timestamp": {
"qualified": true
},
"certificate": {
"owner": "",
"value": "",
"issuer": "",
"valid_to": "2025-02-11 15:10:01",
"qualified": true,
"valid_from": "2020-02-11 15:10:03"
},
"signing_time": "2024-04-18T13:19:56+03:00"
},
"first_name": "",
"signing_method": null,
"is_in_trash_bin": false,
"meta_information": {
"city": null,
"company": null,
"country": null,
"position": null,
"postal_code": null,
"subdivision": null,
"signing_purpose": null,
"signing_location": null
},
"is_qualified_electronic_signature": true
},
{
"code": null,
"type": "viewer",
"email": null,
"token": "1b7d614e4afc6b3959cce8c4edb18dd5e7deb10f",
"status": "pending",
"country": null,
"last_name": "",
"signature": [],
"first_name": "50skills",
"signing_method": null,
"is_in_trash_bin": false,
"meta_information": {
"city": null,
"company": null,
"country": null,
"position": null,
"postal_code": null,
"subdivision": null,
"signing_purpose": null,
"signing_location": null
},
"is_qualified_electronic_signature": false
}
],
"deadline": null,
"template": null,
"categories": [],
"signed_file": [
{
"url": "https://app.dokobit.com/api/signing/421b3e7148eb5448de5722b88892f261d0e16031/download"
}
],
"date_created": "2024-04-18T13:19:23+03:00",
"signer_token": "2c43b4ed99f1817bcf3b618f9edc7e139bd795e4",
"signing_deadline": null,
"is_qualified_signature_required": false
}

Press "Add Webhook" button at the bottom of the page to save this.

Expand now Webhook and click on "Add conditions" - there are three conditions you need to put in.

Press "Add element"

  1. The first condition is the Token, you select that like this

Make sure to the "Select value in the journey builder" is on like this

Click on "Add element" to crate the second condition.

2. The second condition is the Status

Here is "Select value in the journey builder" is off and you write "completed" in as the value

3. The third condition is the Action

Again the "Select value in the journey builder" is off and you write "signing_completed" in as the value

Press Save and the conditions should look like this

Get document file

To be able to get the signed document and use it you need to add an endpoint, lets call it "Get document file".

This is a GET request and the URL is:

Where the last part (d6kclsj394hk8) is your access token.

Press "Add Endpoint" to save this.

Open the Request values

Now you need to paste in the token you copied from the "Send document to signing" endpoint previously.

Press "Save" and then "Test". The reponse should be similar to this.

Did this answer your question?