Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This article goes through purchasing a developer kit from an exhibitor portal, setting up a Captello capture form for lead scanning using the purchased developer kit, and using the developer kit with 3rd party software.

These instructions apply only to Captello-issued developer kits from a Captello exhibitor portal.

Purchasing a Developer Kit and Acquiring Credentials

To purchase a developer kit from an exhibitor portal, follow the steps below:

  • Navigate to the ‘ Orders > New Order’ page. as shown below:

...

  • Add the ‘Developer Kit’ service to the cart.

...

  • Once the order is successful, navigate to the ‘ Orders > My Services’ page. as shown below:

...

  • Click on the developer kit’s details Details hyperlink.

...

  • You will be presented with your credentials.

...

Setting up a Captello Capture Form for Lead Scanning

Info

For information about creating a capture form, refer to https://leadliaison.atlassian.net/wiki/spaces/LL/pages/18931801/Lead+Capture+Management#Creating-an-Event

...

To set up lead scanning with the dev-developer kit credentials on your capture form, follow the steps below:

...

Tip

Your capture form is now ready to scan badges from the Exhibitor Portal event! As usual, make sure to do a test scan with a test badge before going live on the show floor.

Using Third Party Lead Scanning Software

Using a 3rd party software with the developer kit requires additional development from the 3rd party’s end using the following API documentationinstructions below.

API Documentation

The token acquired earlier is to be used as an API key.

...

Code Block
https://api.leadliaison.com/v1.0/badge-scan.json?token={token}&barcodeId={badgeID}

Europe:

...

The majority of clients will use the Production environment by default. However, if Captello has provided specific instructions to use the Europe environment, please use the endpoint below accordingly.

https://eu-api.leadliaison.com/v1.0/badge-scan.json?token={token}&barcodeId={badgeID}

Responses

Invalid Token

Code Block
{
    "success": 0,
    "message: "Exhibitor portal not found"
}

Invalid badge ID

The response will change based on the badge provider used by the Exhibitor Portal organizer).

Example:

Code Block
{
    "success": 0,
    "message: "Exhibitor portal not found"
    "additionalInfo": []
}

Response for a Valid Badge ID

Code Block
{
  "success": 1,
  "info": [
    {
      "ll_field_id": 9,
      "ll_field_unique_identifier": "WorkPhone",
      "value": "111-111-111"
    },
    {
      "ll_field_id": 10,
      "ll_field_unique_identifier": "MobilePhone",
      "value": "(111) 1111-1111"
    },
    {
      "ll_field_id": 16,
      "ll_field_unique_identifier": "FirstName",
      "value": "test"
    },
    {
      "ll_field_id": 17,
      "ll_field_unique_identifier": "LastName",
      "value": "test"
    },
    {
      "ll_field_id": 21,
      "ll_field_unique_identifier": "Email",
      "value": "test@test.com"
    },
    {
      "ll_field_id": 22,
      "ll_field_unique_identifier": "Company",
      "value": "test"
    },
    {
      "ll_field_id": 24,
      "ll_field_unique_identifier": "Website",
      "value": "www.test.com"
    },
    {
      "ll_field_id": 26,
      "ll_field_unique_identifier": "Country",
      "value": "USA"
    },
    {
      "ll_field_id": 27,
      "ll_field_unique_identifier": "City",
      "value": "test"
    },
    {
      "ll_field_id": 28,
      "ll_field_unique_identifier": "State",
      "value": "test"
    },
    {
      "ll_field_id": 29,
      "ll_field_unique_identifier": "StreetAddress",
      "value": "test"
    },
    {
      "ll_field_id": 30,
      "ll_field_unique_identifier": "FullAddress",
      "value": "test"
    },
    {
      "ll_field_id": 31,
      "ll_field_unique_identifier": "Zipcode",
      "value": "1111"
    }
  ],
  "additionalInfo": {
    "action": "default",
    "is_duplicate": false,
    "is_pending": false
  }
}

Response if

...

the Capture Form Does Not Have a Scanner Element

Code Block
{
    "success": 0,
    "message: "Invalid form"
}

Response for an Invalid Token

Code Block
{
    "success": 0,
    "message: "Exhibitor portal not found"
}

Response for an Invalid Badge ID

The response may change based on the badge provider used by the organizer.

Example:

Code Block
{
    "success": 0,
    "message: "Exhibitor portal not found"
    "additionalInfo": []
}