# 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(); 
```


---

# 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.airdesk.ai/interface/administracao/configuracao-do-espaco/opcoes-adicionais-do-widget.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.