O Mateflow conecta sua comunidade a outras ferramentas de três formas: apps conectados (Slack, Discord e Zapier), webhooks para o seu próprio servidor e a Open API para desenvolvedores. As três ficam em uma única página do console de administração, Admin → Configurações → Integrações.
Quem pode fazer isso: proprietários e administradores. · Onde: web (console de administração). · Plano: os webhooks, o acesso à API e o limite diário de requisições da API dependem do seu plano da plataforma.
Onde encontrar as integrações no console de administração
Acesse Admin → Configurações → Integrações. A página se chama Integrações e API e tem quatro abas:
| Aba | O que você faz nela |
|---|---|
| Integrações | Conecta o Slack, o Discord ou o Zapier em Aplicativos Conectados |
| Webhooks | Envia eventos da comunidade para o seu próprio endpoint |
| Acesso à API | Cria e revoga chaves de API e abre a documentação para desenvolvedores |
| Logs de Entrega | Confere cada requisição que o Mateflow enviou para seus webhooks, apps e regras de automação |
Conectar o Slack, o Discord ou o Zapier
Os apps conectados enviam eventos da comunidade, como novos membros, publicações ou pagamentos, para outro serviço:
- Slack: publica mensagens em um canal por meio de uma URL de Incoming Webhook.
- Discord: publica mensagens em um canal por meio de uma URL de webhook do Discord. Ele só envia mensagens; não sincroniza membros nem cargos.
- Zapier: envia eventos para um Catch Hook do Zapier, para que um Zap possa repassá-los a milhares de outros apps.
Para conectar um deles, abra a aba Integrações e clique em Conectar Slack, Conectar Discord ou Conectar Zapier. Cole a URL do webhook desse serviço, escolha os Eventos para enviar, adicione um Segredo de assinatura (opcional) se quiser e clique em Conectar. Depois, clique em Enviar evento de teste para confirmar que as mensagens chegam.
Um card conectado mostra quais eventos ele está enviando. Use o menu dele para Editar configurações, Enviar evento de teste ou Desconectar.
Enviar eventos para o seu próprio servidor com webhooks
Os webhooks enviam uma requisição HTTPS para um endpoint que você controla sempre que um evento escolhido acontece, por exemplo Membro Ingressou, Membro Adicionado ao Grupo de Acesso, Publicação Criada ou Pagamento Recebido. Cada webhook tem seus próprios eventos, um segredo de assinatura opcional e uma chave Ativo. Os webhooks, e quantos você pode criar, dependem do seu plano da plataforma. Veja Configurar webhooks.
Criar sua própria integração com a Open API
A Open API permite que um desenvolvedor leia e grave os dados da sua comunidade a partir do próprio código: ler publicações, espaços e membros, criar publicações, enviar mídia e convidar pessoas. Cada chave de API pertence a uma comunidade, e você escolhe as permissões dela (escopos) ao criá-la. As chaves de API não são gerenciadas no painel do criador (app.mateflow.com); a página Visão geral da comunidade lá tem um link para esta página do console de administração.
Os convites enviados pela API podem incluir grupos de acesso, que a pessoa recebe ao aceitar. Veja Como funcionam os grupos de acesso.
A referência completa da API está em mateflow.com/developers. Na aba Acesso à API, clique em Abrir documentação para chegar lá e envie o link ao seu desenvolvedor; ele não precisa de uma conta na sua comunidade. Veja Criar uma chave de API.
Conferir as requisições enviadas em Logs de Entrega
A aba Logs de Entrega lista as requisições enviadas pelos seus webhooks, pelos apps conectados e pelas regras de automação que usam Disparar webhook. Filtre por Tipo de evento, resultado e data, e clique em Exibir Detalhes para ver a requisição e a resposta completas. Os logs de entrega são mantidos por 30 dias. As entregas de webhook que falham são repetidas automaticamente; não há botão para você reenviar uma delas.
As requisições feitas com suas chaves de API não são registradas aqui. Em vez disso, a aba Acesso à API mostra a data de Último Uso de cada chave.
Artigos relacionados
Este guia foi útil?