Decipher
      Back to home
      1. Docs
      2. Widget Integrations
      3. Decipher

      How Do I Integrate With Decipher?

      Getting Started

      The Phonic recorder can be easily embedded in a FocusVision Decipher survey. Audio recording can be included either as a standalone question or appended to another question type. Including a microphone with a text box allows respondents to fallback to open text if they are unable to (or choose not to) record with voice.

      Audio Only Question

      This XML generates an audio-only question with a simple text prompt. The psid and uuid parameters are optional.

      <html label="cm2" where="survey">
          What is your favourite kind of sparkling water?<br /><br />
          &lt;phonic-embed
              mode="audio"
              theme="square"
              size="large"
              surveyid="paste-survey-id"
              questionid="paste-question-id"
              responseid="${uuid}"
              psid="${psid}"
          &gt;&lt;/phonic-embed&gt;
          &lt;script
              type="text/javascript"
              src="https://api.phonic.ai/phonic-embed.min.js"
          &gt;&lt;/script&gt;
      </html>

      This can also be accomplished with the GUI by creating a new element, clicking More > Source Code, and pasting the following into the text box.

      What is your favourite kind of sparkling water?<br /><br/>
      <phonic-embed
          mode="audio"
          theme="square"
          size="large"
          surveyid="paste-survey-id"
          questionid="paste-question-id">
      </phonic-embed>
      <script
        type="text/javascript"
        src="https://api.phonic.ai/phonic-embed.min.js"
      ></script>

      With Open Text Fallback

      A Phonic microphone can be added to an open text response in a similar manner. If the microphone is being offered as an alternative to the text box, we recommend notifying users of this using the prompt attribute.

      <text
        label="q2"
        size="25">
        <title>
          &lt;phonic-embed
          mode="audio"
          theme="square"
          size="large"
          surveyid="paste-survey-id"
          questionid="paste-question-id"
          prompt="Answer using either your microphone or the text box below"
          &gt;&lt;/phonic-embed&gt;
        </title>
        <comment>What is your favourite kind of sparkling water?</comment>
      </text>

      Customizing Styles

      As with any embedded Phonic widget, the size, theme & prompt attributes can all be customized.

      • size can be set to either large (default) or small.
      • theme can be set to either square (default) or round.
      • prompt can be optionally included to include a question prompt above the recorder.
      • spacing can be added above and below the recorder by specifying a CSS attribute, ex. spacing="10px".

      Panel & Respondent IDs

      Panel or respondent ID can be consumed from either the URL or from psid or uuid params passed as attributes into the Phonic microphone. See an example of the in the "Audio Only Question" section. These fields are optional.

      The URL is also uploaded with every response, and is included as an additional field in the dashboard CSV download. Any additional IDs or parameters can be included in the survey URL.