Průvodce - API

Použití webhook pro zkrácení odkazu na průzkum

Zkrácení odkazu na průzkum můžete provést voláním tzv. webhook metody. Webhook není nic jiného než URL, která se zavolá pomocí jiného informačního systému nebo je otevřena v běžném prohlížeči.

Příkladová URL

https://www.netquest.cz/webhooks/[id_account]/[webhook_key]/[webhook_auth]/[webhook_name]?id_survey=123456&dodatecne_parametry

Kde:

  • id_account – ID Vašeho účtu na platformě Netquest. Pro získání této informace nás prosím kontaktujte.
  • webhook_key a webhook_auth – klíč a autorizace Webhooku. Parametry jsou dostupné po přihlášení v účtu uživatele v záložce Nastavení účtu -> Nastavení -> Integrace. Po vygenerování klíčů získáte tyto hodnoty.
  • webhook_name – v tomto případě, shorten-link
  • dodatecne_parametry – dodatečné nepovinné parametry pro zavolání dotazníku. Tyto jsou:
    • external_key – external_key předaný do průzkumu (zhlédněte dokumentaci external_key)
    • user_token – externí identifikátor uživatele (zhlédněte dokumentaci user_token)
    • token – systémový identifikátor uživatele (zhlédněte dokumentaci tokenu Netquest)
    • l1, l2, …., l10 – dodatečné štítky kontaktu. Štítky musí být předdefinované pro dotazník na který je pozvánka odeslána. Všechny parametry jsou nepovinné.

Příkladová URL s dodatečnými parametry odeslanými metodou GET:

https://www.netquest.cz/webhooks/387487/TUwNjNDg3M/84b750d6956f02503015938fc38bfe36/shorten-link?id_survey=399793&user_token=MNOVAK&l1=Martin&l2=Novak&l3=CEO&l4=VIP&l5=601602603

Výše uvedený webhook zkrátí odkaz do následující podoby:

https://www.netquest.cz/l/4e3/f55400

Na co pamatovat?

  • Pro získání hodnoty parametru id_survey nás prosím kontaktujte.

Pomohl Vám tento článek?

Děkujeme za odpověď