# Workplace

O Workplace Facebook é uma rede social que conecta todos os membros da sua empresa independente do local e lugar, disponibilizando recursos como: feed de notícias, eventos, arquivos, notificações e chat.

## **Compatibilidades**

**input:**

* **Texto**

**Output:**

* **Texto** 
* **Arquivo**
* **Feedback NPS**
* **Quick Replies**
* **Lista de opções Inline e Modal** 
* **Carrossel**

## **Configurações**

Para começar, acesse a plataforma do workplace para configurar sua integração:

* Na barra principal, no canto superior esquerdo, acesse o Painel Administrativo e selecione a seção “Integrações”.

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBjaNm5lB1Yqgih1JCA%2Fuploads%2FeiNpHUSH1XXXGaSAXD0e%2Fworkplace1.gif?alt=media\&token=16293d41-79e1-4d9e-a6f0-e23d3b4ded36)

* Em seguida, clique na opção “Criar integração personalizada” e informe o nome e, se quiser, a descrição da integração.

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBjaNm5lB1Yqgih1JCA%2Fuploads%2FIKkdNE7vLNknrUkzCizC%2Fworkplace2.gif?alt=media\&token=5eeaa60b-6153-4660-b066-0272a766f4ad)

Na seção **Integrações personalizadas**, acesse a integração que foi criada e continue a editar com as seguintes informações: 

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBjaNm5lB1Yqgih1JCA%2Fuploads%2FtxjfjOZX4aSp4oZ1tIKo%2Fworkplace3.gif?alt=media\&token=c4bdc3dd-8729-4ff4-8d8f-2a14799bde75)

* Adicione uma imagem para o assistente
* Salve as as senhas de Identificação:
  * Identificação do aplicativo
  * Chave secreta do aplicativo
  * Token de acesso

Em **Permissões de integração**, você pode habilitar as opções conforme as necessidades do assistente.

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBjaNm5lB1Yqgih1JCA%2Fuploads%2FYaGaGSSj35TjSRCS0mtJ%2Fworkplace4.gif?alt=media\&token=510a3e38-2815-4829-a35a-9fe715840ba3)

Sugerimos ativar as permissões para:

* Ler e-mail do usuário
* Enviar mensagem para qualquer membro
* Ler perfil profissional

Para preencher a seção **Configurar Webhook** é necessário solicitar à equipe do Zenvia NLU, por meio do e-mail <altu@smarkio.com.br>, o token e a URL de acesso.&#x20;

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBjaNm5lB1Yqgih1JCA%2Fuploads%2F39C3MrZRV2CBCIbKEWDY%2Fworkplace5.gif?alt=media\&token=9fcc3c6d-c6ee-4f43-8f3f-361cee8c91a9)

Em **Configurações de segurança**, você pode habilitar, ou não, a opção “Exigir prova da chave secreta do aplicativo”. <br>

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBjaNm5lB1Yqgih1JCA%2Fuploads%2Fhn3pOBHF6fbrEYvfclE7%2FScreen%20Shot%202022-02-14%20at%2014.28.17.png?alt=media\&token=72d07451-cf0c-4839-9024-7bd6d5ae6254)

Salve as edições ao final.

No Zenvia NLU, vá até **Connect > Canais > Workplace**, clique no botão ➕ para criar uma nova integração e preencha os seguintes campos:

![](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBjaNm5lB1Yqgih1JCA%2Fuploads%2FSygXCCgUKa25UirGGJW3%2Fworkplace6.gif?alt=media\&token=9487cc19-d836-4f90-89c3-0836e168022a)

* **Nome:** nome da sua integração
* **Assistente:** selecione o assistente
* **Squad:** selecione o nome da squad se estiver disponível na lista, caso contrário mantenha como “geral”&#x20;
* **App ID:** número de Identificação do aplicativo salvo na seção “Detalhes da integração''
* **App Secret:** número da chave secreta do aplicativo salvo na seção “Detalhes da integração''
* **Access Token:** número do token de acesso salvo na seção “Detalhes da integração''
* **Token de Verificação:** token disponibilizado pela equipe Zenvia NLU para preencher o campo "Verificar Token", na seção Configurar Webhooks
* **Page ID:** Esse valor é encontrado na URL de conversa com o assistente

![Exemplo de PageID no Workplace](https://776911411-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MBjaNm5lB1Yqgih1JCA%2Fuploads%2F2gf1RWYWAlgNt42ogwTK%2FScreen%20Shot%202022-02-14%20at%2014.32.38.png?alt=media\&token=b36fc8b7-d6f5-48d2-ba0a-7708f656896a)

* **Token da API de Outbound:** Token optativo para criação da integração
* **Mensagens para mídias não suportadas:** mensagens que serão exibidas caso o usuário envie uma mensagem não suportada, como áudio ou envio de contato

Caso possua alguma dúvida sobre a integração entre em contato com o time do Zenvia NLU no e-mail <altu@smarkio.com.br><br>


---

# 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.altu.d1.cx/connect/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.