A API Pública de Integração permite realizar determinadas ações com a Integração do Inbox sem a necessidade de utilizar a interface da plataforma. Com a API de Integração, você também pode controlar a integração do inbox com a lógica do chatbot.
Use o seguinte URL de Endpoint para a API Pública de Integração:https://api.inbox.woztell.sanuker.com/v1.0/
Para realizar a autenticação das APIs de Integração, é necessário utilizar o Payload e o SignedContext correspondentes exigidos pela integração.
{"appIntegration":"appIntegrationId","app":"appId"}
(signature).{{base64(JSON.stringify(payload))}}
installedIntegrations
com a Open API.Crie o Payload no seguinte formato:
{"appIntegration":"appIntegrationId","app":"appId"}
Codifique o Payload no formato Base64
Combine o Payload codificado e a Assinatura para criar o SignedContext no seguinte formato:
(signature).{{base64(JSON.stringify(payload))}}
X-Woztell-Payload
e X-Woztell-SignedContext
.Esta API serve para obter uma lista de threads.
Para a autenticação, siga este guia para preencher o X-Woztell-Payload e o X-Woztell-SignedContext no cabeçalho.
Nome | Tipo | Descrição | Obrigatório |
---|---|---|---|
channelId | string | Filtrar threads por canal | Não |
folderId | string | Filtrar threads por pasta | Não |
memberId | string | Filtrar threads por membro | Não |
externalId | string | Filtrar threads por membro usando ExternalId | Não |
threadId | string | Filtrar threads por ID da thread | Não |
userId | string | Filtrar threads pelo responsável atribuído | Não |
limit | integer | Controla a quantidade de threads retornadas (Valor padrão: 10) | Não |
after | string | Para obter o próximo lote de threads, pode ser obtido de paging.cursors na resposta |
Não |
before | string | Para obter o lote anterior de threads, pode ser obtido de paging.cursors na resposta |
Não |
Esta API serve para obter uma lista de usuários do inbox.
Para a autenticação, siga este guia para preencher o X-Woztell-Payload e o X-Woztell-SignedContext no cabeçalho.
Nome | Tipo | Descrição | Obrigatório |
---|---|---|---|
channelId | string | Filtrar usuários por canal (dados do agente como função, nome, e-mail e ícone baseados nos dados do canal) | Não |
folderId | string | Filtrar usuários com acesso à pasta | Não |
userId | string | Filtrar usuário pelo ID do Woztell | Não |
memberId | string | Filtrar usuário por membro | Não |
paging.cursors
da resposta
Não
before
string
Para obter o lote anterior de usuários, use o valor de paging.cursors
da resposta
Não
Esta API serve para atribuir uma thread a uma pasta específica.
Para autenticação, siga este guia e preencha o X-Woztell-Payload e o X-Woztell-SignedContext no cabeçalho.
Nome | Tipo | Descrição | Obrigatório |
---|---|---|---|
memberId | string | ID do membro | Sim |
folderId | string | ID da pasta | Sim |
Esta API serve para adicionar ou remover um responsável por uma thread.
Para autenticação, siga este guia e preencha o X-Woztell-Payload e o X-Woztell-SignedContext no cabeçalho.
Nome | Tipo | Descrição | Obrigatório |
---|---|---|---|
memberId | string | ID do membro | Sim |
userId | string | ID do usuário da equipe | Sim |
O ID do usuário da equipe pode ser obtido a partir de teamMembers
da Open API.
Para adicionar um responsável
Para remover um responsável
Esta API serve para atualizar o título de uma thread.
Para autenticação, siga este guia e preencha o X-Woztell-Payload e o X-Woztell-SignedContext no cabeçalho.
Nome | Tipo | Descrição | Obrigatório |
---|---|---|---|
memberId | string | ID do membro pertencente à thread | Ou memberId ou threadId |
threadId | string | ID da thread | Ou threadId ou memberId |
title | string | Novo título da thread | Sim |
Esta API serve para enviar uma mensagem interna em uma thread.
Para autenticação, siga este guia e preencha o X-Woztell-Payload e o X-Woztell-SignedContext no cabeçalho.
Nome | Tipo | Descrição | Obrigatório |
---|---|---|---|
threadId | string | ID da thread associada ao membro | Ou memberId ou threadId |
memberId | string | ID do membro | Ou threadId ou memberId |
message | string | Mensagem interna a ser enviada | Sim |