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

![](https://1728608858-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LSnqDgLbXBccdKMOdEJ%2F-MWA7t8JLHjqknVZuQN-%2F-MWAACLa_w0Uab-gfzlG%2Fworkplace.gif?alt=media\&token=7dd9c408-0f58-4b83-99bb-c8ae3f2dfcc0)

## Criando o APP no Workplace

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

![](https://1728608858-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LSnqDgLbXBccdKMOdEJ%2F-MWA7t8JLHjqknVZuQN-%2F-MWAB85MyWE0nYO87SMr%2Fintegra%C3%A7%C3%B5es.gif?alt=media\&token=d60a199e-1df4-47a2-a475-7e1d0f162520)

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

![](https://1728608858-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LSnqDgLbXBccdKMOdEJ%2F-MWA7t8JLHjqknVZuQN-%2F-MWABYtTiho6BTC-E4Za%2Fintegra%C3%A7%C3%A3o%20personalizada.gif?alt=media\&token=3c2b93cb-174c-4201-8602-a9f2ef5a51d3)

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

![](https://1728608858-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LSnqDgLbXBccdKMOdEJ%2F-MWA7t8JLHjqknVZuQN-%2F-MWABoxnhgJFSCPOKfZk%2FCriar.gif?alt=media\&token=49c47ffa-6ee1-4650-a479-04ba5840f039)

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

![](https://1728608858-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LSnqDgLbXBccdKMOdEJ%2F-MWA7t8JLHjqknVZuQN-%2F-MWAClV4MgYHzjoS36hd%2Fcriar%20app%20token.gif?alt=media\&token=af921297-ace7-49a3-84b9-6ab3dd555ed5)

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

![](https://1728608858-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LSnqDgLbXBccdKMOdEJ%2F-MWA7t8JLHjqknVZuQN-%2F-MWADZKv5Yz-Mbs24mWn%2Fcopie%20o%20token.gif?alt=media\&token=a2405c25-c55c-453a-9d96-2c61d4691915)

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

<br>

![](https://1728608858-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LSnqDgLbXBccdKMOdEJ%2F-MWA7t8JLHjqknVZuQN-%2F-MWAELUHflFwERzlHABx%2FLer%20e%20enviar.gif?alt=media\&token=c9b51db3-21cc-482a-a428-24c39939a134)

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

![](https://1728608858-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LSnqDgLbXBccdKMOdEJ%2F-MWA7t8JLHjqknVZuQN-%2F-MWANphByrg6rV8nLAkr%2Ftoken.gif?alt=media\&token=dd6bc8c9-e933-4b4c-a13a-c8c4a5bc4db5)

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

![](https://1728608858-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LSnqDgLbXBccdKMOdEJ%2F-MWA7t8JLHjqknVZuQN-%2F-MWAOJw-7f-lBEfEQgnl%2Fwebhook.gif?alt=media\&token=a7f70e86-588b-45e1-8536-7baeea605afa)

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

![](https://1728608858-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LSnqDgLbXBccdKMOdEJ%2F-MWA7t8JLHjqknVZuQN-%2F-MWAMRoPXT0aD-hyD-0-%2Ffoi.gif?alt=media\&token=92be2342-cada-4d40-86c6-7ae9ca62f07f)

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

![](https://1728608858-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LSnqDgLbXBccdKMOdEJ%2F-MWA7t8JLHjqknVZuQN-%2F-MWAPq9mc5whJQO2tMOW%2Ftestando.gif?alt=media\&token=04db10dc-d7ad-4cd6-8a8c-446bf39bd7b5)