> For the complete documentation index, see [llms.txt](https://docs.altu.d1.cx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.altu.d1.cx/connect/canais/workplace.md).

# 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**&#x20;
* **Arquivo**
* **Feedback NPS**
* **Quick Replies**
* **Lista de opções Inline e Modal**&#x20;
* **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”.

![](/files/7SshrxFU1DIEP71NFgaa)

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

![](/files/HEQ9oNkV1FKAEofAKiY7)

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

![](/files/WHNFpt0NBEnGwHZ31Ysm)

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

![](/files/XXi59tHmEpYlRonbTfly)

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;

![](/files/7IOJdlzUiN6p61xDZuTU)

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

![](/files/XP8tMhA36ObS2bM1yzqY)

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:

![](/files/l9rErtSzWyZB5u3Hgm1R)

* **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](/files/pRF8mzxmZI4CdWYIOQKA)

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