Workplace

Integrações personalizadas

Integre o Workplace ao seu fluxo de trabalho existente com o poder das APIs do Workplace. Integrações personalizadas são adequadas para o desenvolvimento interno da sua organização (ou desenvolvimento customizado para uso exclusivo de um único cliente do Workplace).

Visão geral

Integrações personalizadas no Workplace são serviços que usam a Graph API e a API de gerenciamento de conta para estender a funcionalidade do Workplace.

Ao criar um app de integração personalizada, você pode manter as informações dos funcionários sincronizadas com um serviço de identidade, automatizar a associação a grupos, fazer backups de publicações em grupos ou automatizar a publicação em grupos específicos com base nas atividades em outro serviço.

Também é possível usar integrações personalizadas para criar bots de grupo e bate-papo que podem se comunicar em grupos no Workplace e no Work Chat.

Integrações personalizadas são adequadas para o desenvolvimento interno da sua organização (ou desenvolvimento customizado para uso exclusivo de um único cliente do Workplace). Se você tiver uma finalidade diferente, por exemplo, oferecer uma integração SaaS ou PaaS para vários clientes do Workplace, utilize apps de terceiros.

Os tokens de acesso gerados para integrações personalizadas não são vinculados ao usuário que os gerou. Como resultado disso, os tokens não expiram nem se alteram quando um usuário é removido ou desativado. Eles permanecem válidos até serem alterados manualmente por um administrador do Workplace ou caso a integração personalizada seja desativada.

Como criar apps para o Workplace

A Graph API e a API de gerenciamento de conta do Workplace são APIs disponíveis abertamente que podem ser chamadas por qualquer desenvolvedor que saiba como chamar APIs baseadas em REST. O acesso a essas APIs é controlado por apps, com permissões específicas e protegido por tokens de acesso.

Somente os administradores de sistema de uma comunidade do Workplace podem criar apps e gerar tokens de acesso dentro dessa comunidade.

Apps e páginas

Quando você cria uma integração personalizada, dois objetos são criados:

  • Um app, que tem permissões específicas definidas na tela Editar aplicativo.
  • Uma página, do tipo "Bot", que é visível apenas dentro da sua comunidade do Workplace. O nome da página reflete o nome de sua integração personalizada, e sua imagem de perfil corresponde ao ícone que você escolheu ao criar a integração personalizada.

Um token de integração personalizada é gerado e mostrado a você ao criar sua integração personalizada. Esse token pode ser usado para ler e escrever publicações como sua página.

Como criar integrações personalizadas

Para criar um app para o Workplace, siga as etapas abaixo:

  1. No Painel Administrativo, abra a guia Integrações.
  2. Clique no botão Criar aplicativo.
  3. Escolha um nome e uma descrição relevantes para o app.
  4. Adicione uma foto de perfil para o app. Ela será usada sempre que o app for representado visualmente, por exemplo, se ele fizer uma publicação no grupo.
  5. Escolha as permissões necessárias para o app de acordo com a funcionalidade de integração de que você precisa.
  6. Copie e armazene com segurança o token de acesso que é mostrado a você. Você precisará dele para fazer chamadas à API.

Leia mais

Para saber mais sobre como criar apps para o Workplace, ou para descobrir casos de uso de integrações personalizadas, leia os guias abaixo.