# Como criar um certificado

Você pode criar e configurar quaisquer certificados como desejar, sem conhecimento técnico aprofundado.

{% hint style="success" %}
Os certificados emitidos podem ser recriados e modificados, se necessário.
{% endhint %}

O construtor de certificados da MaviBot oferece a possibilidade de criar um certificado com ou sem vínculo ao seu curso.

<div data-with-frame="true"><figure><img src="/files/09052c8055cd494e244a2dd8840de157804c3551" alt="" width="563"><figcaption></figcaption></figure></div>

Personalize seu certificado, transforme sua imaginação em realidade, use quaisquer imagens que quiser! Você também pode inserir vários textos e formatá-los como preferir.

## Vamos começar!

Para criar um certificado, vá até a aba “Cursos”, onde haverá duas abas na parte superior. Você precisa ir para o “Construtor de certificados”.

<div data-with-frame="true"><figure><img src="/files/037e91a5bc56079d0ac9d7784418ff71771eb1a5" alt="" width="563"><figcaption></figcaption></figure></div>

Se você ainda não tiver nenhum certificado criado, o botão será exibido no centro da área de trabalho; se você tiver produtos prontos, ele ficará no lado direito da tela.

<div data-with-frame="true"><figure><img src="/files/7c0da5f59d7198131d761bad3a72bca7e931b547" alt=""><figcaption></figcaption></figure></div>

Depois de clicar no botão "Criar", você irá para as configurações básicas do certificado.

<div data-with-frame="true"><figure><img src="/files/4cecac2994ead2738b86775c3959d17a8381468a" alt="" width="428"><figcaption></figcaption></figure></div>

### Configurações principais do certificado

Nas configurações principais do certificado, são configurados o formato e o vínculo com o curso. Se você já tiver um curso, a imagem do certificado é selecionada.

**Nome do certificado** é um campo de texto para o nome do seu certificado.

<div data-with-frame="true"><figure><img src="/files/724390a4718b3e4b1bbc5bb0e0ba3e887b20fd17" alt=""><figcaption></figcaption></figure></div>

**O formato do certificado** permite selecionar o formato do seu certificado: 1:1 (quadrado), 16:9 (retangular) ou 4:3 (retrato).

<div data-with-frame="true"><figure><img src="/files/8af06226d313f865eb9378089f26126d19fc4f1e" alt=""><figcaption></figcaption></figure></div>

{% hint style="warning" %}

## Atenção

A imagem enviada deve corresponder ao formato selecionado.
{% endhint %}

**Depois, você pode selecionar o curso** e o plano ao qual seu certificado será vinculado.

<div data-with-frame="true"><figure><img src="/files/0caa122c34a50bfa70834c3d1df061bc41ed6861" alt="" width="498"><figcaption></figcaption></figure></div>

Se você não tiver nenhum curso, pode pular esta etapa.

{% hint style="info" %}
As configurações do certificado não exigem que você o vincule a um curso específico ou a um plano de preços. Essa configuração garante que o aluno receberá o certificado após concluir com sucesso qualquer curso do seu catálogo, em qualquer plano disponível.
{% endhint %}

Se você quiser emitir uma imagem personalizada como certificado, use a caixa de seleção "Imagem personalizada" sem referência ao curso:

<div data-with-frame="true"><figure><img src="/files/5919369a4d7e92da35dfaa7ba42cfda5b0d531e4" alt="" width="488"><figcaption></figcaption></figure></div>

{% hint style="info" %}
Como criar imagens personalizadas e exibi-las por meio de um bot é descrito no artigo "[Imagens personalizadas](/doc/pt/como-fazer.../imagens-personalizadas.md)".
{% endhint %}

No campo “**Enviar certificado**”, insira a imagem que será o plano de fundo do seu certificado.

<div data-with-frame="true"><figure><img src="/files/9fc6feb5fe4f14331bd5263fda91fc1195627cf0" alt="" width="491"><figcaption></figcaption></figure></div>

Você pode baixar a imagem do seu dispositivo ou adicionar um link para ela a partir do armazenamento de arquivos.

Para adicionar um certificado do armazenamento de arquivos, envie uma imagem na seção apropriada.

<div data-with-frame="true"><figure><img src="/files/92f70c7527adc55b256af3bcd7f3e79543ba34f7" alt=""><figcaption></figcaption></figure></div>

Depois, copie o link para ela:

<div data-with-frame="true"><figure><img src="/files/67de6cb398ce4d327331dabae9b121636bf8d0c0" alt=""><figcaption></figcaption></figure></div>

E cole o link no campo URL no construtor de certificados:

<div data-with-frame="true"><figure><img src="/files/b1e6167df21e571bf5f59de1abf581b84c7b2e66" alt=""><figcaption></figcaption></figure></div>

Depois clique no botão “**Salvar**”.

<div data-with-frame="true"><figure><img src="/files/e51a67836e656ce15c426237bc2080b3a11d5019" alt="" width="389"><figcaption></figcaption></figure></div>

Haverá a linha “Configurar campos de entrada”. Clique nela para continuar configurando o certificado:

<div data-with-frame="true"><figure><img src="/files/81dcde2a4ef93e8f0a51d5733947baf84caff5b0" alt="" width="389"><figcaption></figcaption></figure></div>

### Configurações dos campos de entrada

{% hint style="success" %}

## Atenção

O certificado exibirá os dados que o aluno inseriu em sua conta pessoal. Portanto, é importante avisar seus alunos de que os dados devem ser preenchidos corretamente: nome completo e foto do aluno.
{% endhint %}

Configure o texto padrão nesses campos de entrada. Seus valores serão preenchidos automaticamente no momento da emissão do certificado.

<div data-with-frame="true"><figure><img src="/files/ed756928ba44fa6f11465a50a65cf664267f68a0" alt=""><figcaption></figcaption></figure></div>

**Nome**

Este campo define o **nome do destinatário**. Quando o aluno concluir o curso, seu nome será inserido automaticamente neste campo no certificado.

Você tem controle total sobre a aparência: escolha a fonte, ajuste o peso e o tamanho, selecione uma cor e defina sua posição exata.

<div data-with-frame="true"><figure><img src="/files/990497838700ff77619b4b7458699ec2d14705fb" alt=""><figcaption></figcaption></figure></div>

Você pode editar elementos de texto diretamente na visualização do certificado:

* **Para mover:** Passe o cursor sobre o texto até que ele mude para o ícone de uma mão. Depois, clique e arraste o elemento para a nova posição.
* **Para redimensionar:** Passe o cursor sobre o canto inferior direito da caixa de texto até que ele mude para uma seta de redimensionamento. Clique e arraste para ajustar o tamanho.\
  Todas as alterações são refletidas instantaneamente no painel de configurações.

<div data-with-frame="true"><figure><img src="/files/42889d1c5215f23cbf428136da51861d40c3da64" alt=""><figcaption></figcaption></figure></div>

**Data**

Exibe a data de emissão do certificado, que é definida automaticamente como a data de conclusão do curso pelo aluno.

> **Lógica:** Para cursos com tarefa de casa, a data reflete o envio da última atividade. Caso contrário, é a data da aula final.

<div data-with-frame="true"><figure><img src="/files/48f4acc9218014dc12508a3de83a5c888964d422" alt=""><figcaption></figcaption></figure></div>

**Avatar**

Exibe a foto de perfil do aluno. Você pode personalizá-la alterando sua posição e selecionando um formato (por exemplo, círculo, quadrado, quadrado arredondado).

<div data-with-frame="true"><figure><img src="/files/d496b09f865cf427c46ff09ddd9f524c5151658d" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}

## Atenção

* Se você não quiser que um avatar seja exibido no seu certificado, não preencha os campos.
* Se você escolher exibir um avatar no certificado, mas a foto não estiver enviada na conta pessoal do aluno, um avatar vazio será exibido no certificado.
  {% endhint %}

**O número de série de um certificado** consiste em uma série e um número. Você pode inserir a série manualmente e editá-la da mesma forma que o nome ou a data. O número é gerado automaticamente quando o certificado é emitido.

<div data-with-frame="true"><figure><img src="/files/07a556a4b801826ccc9c9d56ea87404543f88ae0" alt=""><figcaption></figcaption></figure></div>

Você também pode adicionar qualquer texto.

<div data-with-frame="true"><figure><img src="/files/42096e5af8bdbdd64a3f9ce3e77fe826e449358f" alt=""><figcaption></figcaption></figure></div>

Para fazer isso, clique em “Adicionar texto”, depois insira o texto necessário e edite-o como quiser. Para aumentar ou diminuir o tamanho do seu texto, você precisa inserir um valor numérico no campo “Tamanho”.

{% hint style="success" %}
Se você quiser que o texto tenha o mesmo estilo, pode copiar o tamanho e a cor do texto, e selecionar a fonte e a espessura adequadas.
{% endhint %}

Para evitar perder todo o progresso da configuração, clique no botão “Salvar”.

<div data-with-frame="true"><figure><img src="/files/fe11bcde1a4f13ee26bbde65552cefef1bb1d5ae" alt=""><figcaption></figcaption></figure></div>

Depois de configurar todos os dados, você pode baixar uma prévia para ver como ficará o certificado dos seus alunos:

<div data-with-frame="true"><figure><img src="/files/ea76360487f334b75d0ffede81b446b86812003d" alt=""><figcaption></figcaption></figure></div>

{% hint style="success" %}
Todos os certificados criados são exibidos no "Construtor de certificados". Você sempre pode substituí-los ou alterar as configurações.
{% endhint %}

Seu certificado agora está ativo! Ele será **emitido automaticamente** para os alunos que concluírem com sucesso os critérios do curso (todas as aulas e qualquer tarefa de casa obrigatória) e estará disponível para download em suas contas pessoais.

## Emissão de certificados por meio de um chatbot

Para configurar a emissão de certificados por meio do seu chatbot, siga estas etapas:

1. Navegue até o fluxo do bot que irá lidar com a entrega do certificado.
2. Adicione um novo bloco a esse fluxo.
3. Dentro do bloco, selecione a função **Calculadora** e configure-a para operações com certificados.

**get\_certificate(course\_id, name\_on\_cert, avatar, date, tariff\_id, texts)**

{% hint style="warning" %}

## Atenção

Usar essa função dentro do seu bot consome recursos equivalentes ao envio de **10 mensagens padrão**.
{% endhint %}

{% hint style="danger" %}

## &#x20;Atenção

A configuração do certificado nas configurações do curso deve ser concluída antes de usar essa função.
{% endhint %}

<table><thead><tr><th width="231">Parâmetros da função</th><th>Descrição do parâmetro</th></tr></thead><tbody><tr><td><mark style="color:vermelho;"><strong>!</strong></mark><strong> course_id</strong></td><td>ID do curso</td></tr><tr><td><mark style="color:vermelho;"><strong>!</strong></mark><strong> name_on_cert</strong></td><td><p>nome no certificado</p><p>(você pode perguntar ou pegá-lo diretamente do cartão de um cliente)</p></td></tr><tr><td><strong>avatar</strong></td><td><p>parâmetro opcional, 1 - se você precisar transmitir o avatar do cliente, 0 - se não</p><p><em>(0 é o valor padrão, não se esqueça de configurar a exibição do avatar no curso se quiser transmiti-lo)</em></p></td></tr><tr><td><strong>date</strong></td><td><p>parâmetro opcional, data em qualquer formato</p><p><em>(o padrão será a data atual)</em></p></td></tr><tr><td><strong>tariff_id</strong></td><td><p>um parâmetro opcional é necessário se você quiser emitir um certificado configurado para um plano</p><p><em><strong>(</strong><mark style="color:vermelho;"><strong>!</strong></mark><strong> </strong><strong>(o plano deve ser configurado previamente)</strong></em></p></td></tr><tr><td><strong>texts</strong></td><td><p>é um parâmetro opcional para passar uma matriz de textos.</p><p>(se você transmitir <strong>mais textos</strong> do que configurou, então <strong>simplesmente descarte os extras</strong>; se você transmitir <strong>menos</strong>, ele <strong>exibirá os que você transmitiu</strong>)</p></td></tr></tbody></table>

{% hint style="danger" %}
! <mark style="color:vermelho;">**Erros no envio de parâmetros:**</mark>

* Se o parâmetro course\_id for passado incorretamente, a função retorna <mark style="color:vermelho;">**o erro wrong course\_id.**</mark>
* Se o parâmetro tariff\_id for passado incorretamente, ele retorna <mark style="color:vermelho;">**o erro wrong tariff\_id.**</mark>
  {% endhint %}

{% hint style="success" %}
Depois de configurado, o bot emitirá o certificado ao aluno por meio de uma mensagem de chat com um link de acesso.
{% endhint %}

{% hint style="info" %}
Para aprender a criar e emitir imagens personalizadas usando o construtor de certificados, consulte o artigo "[Imagens personalizadas](/doc/pt/como-fazer.../imagens-personalizadas.md)".
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/pt/lms/certificate/builder.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.