---
title: "Gerar questionário via iframe"
method: POST
path: "/perguntasIframe"
tags: ["Questionário"]
---

# Gerar questionário via iframe

`POST /perguntasIframe`

### Descrição

A **Geração de Questionário via iframe (KBA)** é uma variação da tecnologia de Questionário do **BigID** que cria, em tempo real, um questionário de múltipla escolha com base nas configurações definidas pelo cliente no **BDC Center**. Além da geração do questionário, este endpoint retorna um **link de exibição** que permite visualizar e responder às perguntas diretamente em uma interface hospedada pelo BigID.

Essa abordagem possibilita que o questionário seja apresentado ao usuário final por meio de redirecionamento ou incorporado em um elemento `<iframe>` na aplicação do cliente, reduzindo o esforço de implementação na camada de front-end e acelerando a adoção da tecnologia.

A funcionalidade é indicada para os mesmos cenários da geração de questionário via API, como onboarding digital, autenticação, redefinição de senha e prevenção à fraude, mantendo total consistência de regras e comportamento.

Para mais informações sobre casos de uso, principais dúvidas e orientações de aplicação, acesse [Questionário](/docs/questionáriokba).

### Tabela de preços

A cobrança é realizada conforme o volume mensal de consultas, de acordo com a tabela abaixo:

| Consultas realizadas no mês | Valor por consulta |
|:---------------------------:|:------------------:|
| 1 – 10.000 | R$ 0,170 |
| 10.001 – 50.000 | R$ 0,162 |
| 50.001 – 100.000 | R$ 0,153 |
| 100.001 – 500.000 | R$ 0,146 |
| 500.001 – 1.000.000 | R$ 0,138 |
| 1.000.001 – 5.000.000 | R$ 150.000,00 (preço fixo) |
| Acima de 5.000.000 | [Entre em contato](mailto:comercial@bigdatacorp.com.br) |

## Request body

- GenerateQuestionnaireRequest — Objeto de request para geração de questionário (KBA).
  - `Parameters` string[], required — Lista de pares chave=valor com os dados da pessoa para geração do Questionário (KBA). São obrigatórios CPF (11 dígitos numéricos) OU CRM (identificador interno do cliente). Opcionalmente, podem ser enviados NAME, EMAIL, PHONE (DDD + número) e BIRTH_DATE (yyyy-MM-dd).
  - `ShowCorrectAnswers` boolean — Indica se a chamada deve mostrar as respostas corretas para cada pergunta.
  - `ShowInfoType` boolean — Retorna o grupo de informações de cada pergunta gerada.
  - `Group` string — Indica qual grupo de configuração usar.

## Response `200`

Questionário gerado com sucesso.

- GenerateQuestionnaireResult — Estrutura de retorno da geração de questionário (KBA).
  - `PageLink` string — URL segura gerada pelo BigID que exibe o questionário pronto para ser respondido pelo usuário (somente no Gerar Questionário via iframe)
  - `Questions` object[] — Lista de perguntas e alternativas de resposta geradas para o questionário.
    - `Question` string — Pergunta.
    - `Options` string[] — Lista de alternativas de resposta para a pergunta.
  - `TicketId` string — Identificador do questionário gerado.
  - `ResultCode` integer — Código de resultado.
  - `ResultMessage` string — Mensagem de resultado.

---

[API](https://skmtc.net/bigdatacorp/apis/bigid.md) · [All operations](https://skmtc.net/bigdatacorp/apis/bigid/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bigdatacorp/bigid/versions/74abe72d7efc/schema)