# Workplace

A integração com o Workplace permite que o bot criado fique responsável por toda conversa iniciada neste canal. Para todos os usuários presentes em sua Workplace.

Para isso vamos precisar de 2 Tokens, o **App ID** e **App Access Token**. Vamos te ensinar passo a passo como obtê-los.

![](/files/-MWAACLa_w0Uab-gfzlG)

## Criando o APP no Workplace

1-Clique em **Painel Administrativo** e depois em **Integrações**:

![](/files/-MWAB85MyWE0nYO87SMr)

2- No final da pagina clique em **Criar Integração personalizada:**

![](/files/-MWABYtTiho6BTC-E4Za)

3- Defina um nome para sua integração e salve:

![](/files/-MWABoxnhgJFSCPOKfZk)

## **Obtendo o APP Secret e APP Acces Token**&#x20;

1- Clique no aplicativo criado, uma caixa de diálogo irá aparecer e nela você visualizará seu **App ID** e o botão para gerar o seu **App Acces Token.** Clique no botão criar token de acesso:

![](/files/-MWAClV4MgYHzjoS36hd)

2- Copie seu Token de acesso, clique em estou ciente e depois clique em Concluir:

![](/files/-MWADZKv5Yz-Mbs24mWn)

3- Na seção **Permissões de integração** selecione as opções **Ler Todas as mensagens,** **Enviar Mensagens Para Qualquer Membro :**

<br>

![](/files/-MWAELUHflFwERzlHABx)

## Configurar webhooks

1- Em configurar Webhooks,  no campo **URL de retorno de chamada,** insira essa url:[**https://api.cosmobots.io/brain/wkp**](https://api.cosmobots.io/brain/wkp) e no campo **Token de verificação,** insira esse token: **cosmobots**, conforme exemplo:

![](/files/-MWANphByrg6rV8nLAkr)

2- Depois, selecione as opções **mention, messages** e **messaging\_postbacks** e clique em salvar:

![](/files/-MWAOJw-7f-lBEfEQgnl)

## Adicionando os dados ao bot

1- Por fim, acesse o bot que deseja integrar com o Workplace, vá em Canais>Workplace e adicione os dados copiados (**Token de Acesso** e **Identificação do aplicativo**) e salve:

![](/files/-MWAMRoPXT0aD-hyD-0-)

## Testando&#x20;

1- Para testar a integração em Workplace, clique no **ícone de bate papo** que fica localizado do lado esquerdo, na barra de pesquisa **busque pelo nome do app**, clique nele e mande um oi, o seu bot irá responder:

![](/files/-MWAPq9mc5whJQO2tMOW)


---

# 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://help.cosmobots.io/help/bot-builder/canais/workplace.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.
