O que você pode conectar hoje
Webhook para o seu serviço
Uma API de entrada por HTTP POST permite publicar mensagens enviadas por um sistema, script ou automação. Você informa um título ou texto e, se necessário, um link HTTPS. A conexão determina em qual canal interno a mensagem aparece.
Sentry
Receba erros e alertas de métricas usando uma integração interna do Sentry. A configuração utiliza o Client Secret da integração para verificar as requisições. A mensagem apresenta o alerta e o link de origem; ela não é uma cópia completa do evento.
PostHog
Receba notificações de Alerts ou eventos de uma HTTP Webhook Destination. Escolha o que deve chegar ao canal para evitar transformar cada evento do produto em uma interrupção. A configuração de filtros fica no PostHog.
Esses são os três provedores do catálogo atual. Uma automação capaz de enviar HTTP pode ser configurada para o webhook genérico; isso não significa que exista um aplicativo nativo específico para cada serviço.
Configure a conexão e prove a entrega
- Abra Configurações → Integrações → Aplicativos e alertas.
- Escolha Webhook, Sentry ou PostHog e dê um nome que identifique a origem.
- Selecione o canal interno. Você precisa de permissão para gerenciar integrações e para publicar no destino.
- Configure a autenticação adequada e copie a URL exibida ao criar a conexão.
- Configure a ferramenta de origem e envie um teste por ela.
- Confira a mensagem no canal e o histórico da conexão no Joii.
O teste iniciado no Joii verifica a publicação pelo seu fluxo de entrega. O teste enviado pelo serviço externo também verifica a configuração e a autenticação na origem. Para o passo a passo com um exemplo, veja como enviar mensagens por webhook.
Controle as conexões e acompanhe o que aconteceu
A tela reúne busca, filtros e estados das conexões. Você pode pausar, revogar ou gerar outra URL, além de consultar entregas aceitas e reenviar as que permitem nova tentativa. O histórico distingue mensagens na fila, entregues, com falha ou descartadas.
A URL funciona como credencial e aparece ao criar ou rotacionar a conexão. Guarde-a na configuração do serviço, nunca em uma página pública. O webhook genérico aceita autenticação pela própria URL ou assinatura Standard Webhooks. Sentry usa seu modo específico de assinatura.
Escolha uma conexão por destino. Para enviar a dois canais, configure duas conexões. Quando o sistema de origem mudar ou deixar de ser usado, pause ou revogue sua conexão no Joii.
Conecte também agenda, reuniões e arquivos
Além das integrações que publicam em canais, o Joii tem conexões de conta para Google e Microsoft. Elas atendem a outras partes da rotina e dependem de habilitação no ambiente, autorização e elegibilidade da conta.
Google Meet e Microsoft Teams: crie reuniões usando a conta pessoal conectada. A agenda do Joii reúne reuniões, eventos das agendas Google/Outlook conectadas e tarefas com prazo, com vistas de mês, semana, dia e lista.
Google Drive e OneDrive: conecte a conta, escolha as pastas e acesse a biblioteca de arquivos conforme as permissões configuradas. O acesso a uma conversa não libera automaticamente toda a conta de armazenamento.
Quando uma integração ainda não estiver habilitada no ambiente, ela aparece como em breve na tela correspondente. Confirme essa disponibilidade antes de planejar seu fluxo. Essas conexões de conta são diferentes da API de webhook que recebe alertas.
Qual é o alcance desta API?
A API recebe mensagens e alertas para canais internos. Nesta versão, mensagens diretas e canais compartilhados entre empresas não são destinos. O corpo enviado não escolhe outro canal, autor ou menções; o destino já está definido na conexão.
Não é uma API geral para ler o histórico, administrar pessoas ou sincronizar sistemas em duas direções. Integrações de Jira com criação de issues e ações interativas não fazem parte do catálogo atual. A integração de Atendimento por WhatsApp também é um recurso separado, anunciado como em breve.
As requisições estão sujeitas a limites de tamanho e frequência. Corpos idênticos podem ser deduplicados. Se cada ocorrência precisar de uma mensagem, inclua um identificador ou horário no conteúdo e planeje como o serviço trata falhas. O guia técnico detalha o contrato atual.
Perguntas frequentes
Preciso ter uma conta Slack para integrar o PostHog?
Não. Use uma notificação Webhook no alerta ou uma HTTP Webhook Destination, apontando para a conexão criada no Joii.
Posso enviar para canais de clientes e fornecedores?
A API de entrada atual publica somente em canais internos. Canais compartilhados entre organizações e mensagens diretas não são destinos nesta versão.
É possível consultar mensagens por essa API?
Este recurso recebe publicações. Ele não oferece uma API geral para ler mensagens ou administrar o workspace.