> For the complete documentation index, see [llms.txt](https://docs.airdesk.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airdesk.ai/interface/administracao/configuracao-do-espaco/opcoes-adicionais-do-widget.md).

# Opções adicionais do Widget

Dentro do código gerado pelo Airdesk, é possível adicionar opções extra de manipulação do widget. 

Exemplo de um código gerado pelo Airdesk que é colocado na página do cliente:

```markup
 <script defer> 

      (function (a, i, r, d, e, s, k) { 

        a.airdesk = { settings: { cpid: "TEST-EXAMPLE" } }; 

        e = i.getElementsByTagName("head")[0]; 

        s = i.createElement("script"); 

        s.async = 1; 

        s.src = r + d; 

        e.appendChild(s); 

        a.$airdeskOnLoad = () => { 

          var {$airdesk} = a;

//Opções extra são adicionadas abaixo desta linha 

}; 

      })(window, document, "https://script.airdesk.ai/v1/", "air.js"); 

    </script> 
```

| Opção                     | Explicação                                                                                                                                                                                                                                |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| $airdesk.open()           | O widget irá abrir o formulário automaticamente, assim que estiver pronto                                                                                                                                                                 |
| $airdesk.close()          | O widget fecha o formulário                                                                                                                                                                                                               |
| $airdesk.language(CODE)   | <p>Se o utilizador não tiver uma linguagem já guardada. <br>Esta opção permite escolher uma linguagem inicial, em vez de escolher a linguagem inicial consoante a linguagem do browser.  Exemplos de CODE "en-GB", "pt-PT", "en-ES". </p> |
| $airdesk.position(STRING) | <p>Muda o posicionamento inicial para um pré-efeito. </p><p>$airdesk.position(‘bl’)  -  Muda o posicionamento do widget para o canto inferior esquerdo. </p>                                                                              |
| $airdesk.right(NUMBER)    | Substitui o posicionamento inicial do botão widget à direita. O posicionamento é feito á base de px.                                                                                                                                      |
| $airdesk.left(NUMBER)     | Substitui o posicionamento inicial do botão widget à esquerda. O posicionamento é feito à base de px.                                                                                                                                     |
| $airdesk.bottom(NUMBER)   | Substitui o posicionamento inicial do botão widget na vertical com início por baixo. O posicionamento é feito à base de px.                                                                                                               |
| $airdesk.top(NUMBER)      | Substitui o posicionamento inicial do botão widget na vertical com início por cima. O posicionamento é feito à base de px.                                                                                                                |
| $airdesk.hidden()         | Esconde o widget da página. Já não permite carregar no botão e abrir o formulário                                                                                                                                                         |
| $airdesk.visible()        | Mostra o widget que tiver sido escondido.                                                                                                                                                                                                 |

{% hint style="info" %}
Para utilizar funções do widget com javascript, estas, têm de ser sempre chamadas  dentro de um evento load.&#x20;

window\.addEventListener('load', function() { } )
{% endhint %}

É possível chamar estas opções após a inicialização do widget como por exemplo, fazer com que o widget, após ser carregado na página, abra automaticamente o formulário do seguinte modo:

```markup
 <script defer> 

      (function (a, i, r, d, e, s, k) { 

        a.airdesk = { settings: { cpid: "TEST-EXAMPLE" } }; 

        e = i.getElementsByTagName("head")[0]; 

        s = i.createElement("script"); 

        s.async = 1; 

        s.src = r + d; 

        e.appendChild(s); 

        a.$airdeskOnLoad = () => { 

          var {$airdesk} = a;

//Opções extra são adicionadas abaixo desta linha 

$airdesk.open() 

}; 

      })(window, document, "https://script.airdesk.ai/v1/", "air.js"); 

    </script> 
```

Ou, também é possível chamar as opções no javascript do cliente após o widget estar inicializado, da seguinte forma:&#x20;

```javascript
window.$airdesk.open(); 
```