> 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** * **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 , o token e a URL de acesso. ![](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”.
![](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” * **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