Product Features
Bindbee Embed Integration Steps
this guide provides a step by step process for embedding bindbee react sdk, including adding organization details, generating an api key, and creating a link token start by adding your organisation details navigate to the settings and select the organisation settings here, upload your brand logo, favicon logo, and choose a custom brand color save the changes generate api key use the api key you have already stored in case if misplaced it, then regenerate it note if you are changing the api key, all your existing integrations may stop working as you would have already used the old account token (api key) for those integrations navigate to the api key section regenerate the api key, and retrieve it copy and save the api key safely on your local machine follow documentation to proceed with bindbee embed using bindbee embed is a four step process outlined in the documentation step 1 generate a link token to initialize a bindbee embed session for your end user step 2 embed bindbee embed in your frontend using the react sdk https //www npmjs com/package/@bindbee/react link step 3 retrieve the temporary token upon successful integration step 4 exchange the temporary token for a connector token , which authenticates future requests to the unified api step 1 generate link token to get the link token, make a post request to the url "https //api bindbee dev/api/embedded/v1/link/create link token" with the api key generated above and the following payload data = { "end user data" { "org name" ,# unique entity name of your customer's organisation ex "netflix" "origin id" # unique id to identify your customer's organisation ex "netflix unique id" }, "category" ,# category ex "hris" "integration" # integration name ex "hibob" } to get the integration name, go to the documentation and go to the integrations section all integration names are listed there for example, if you want to connect with hibob, the category would be "hris" and the integration name would be "hibob" write the logic to retrieve the link token in a function, handleconnect which can be called on clicking a button step 2 install react sdk install the bindbee react sdk by copying the command npm install save @bindbee/react link or yarn add @bindbee/react link from the documentation and running it in your project terminal step 3 getting temporary token define functions for success and close events the success function is called after a successful integration and returns a temporary token use this temporary token to get your connector token step 4 get connector token from the temporary token fetch the connector token by making a get request to the url "https //api bindbee dev/api/embedded/v1/connectors/connector token/{temporary token}" using the api key retrieved earlier replace the temporary token in the above url with your actual temporary token the close function should handle the exit procedure gracefully if the user clicks the close button on the integration card run project for example, to integrate with bamboohr, click on the connect button you can call the function to get the link token and then call the function returned by the bindbee react sdk this will generate the temporary token which will be used to get the connector token internally the integration card made by bindbee react sdk will appear follow the required procedure to authenticate your connector, then click on connect to view the entire process the connection should now be successfully established