> For the complete documentation index, see [llms.txt](https://help.cosmobots.io/help/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.cosmobots.io/help/bot-builder/canais/workplace.md).

# 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** 

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)