Webhooks e avisos no Slack, Microsoft Teams ou Discord
No Pro e no Team, abra Painel > Integrações para mandar eventos do Pandafile para um canal do Slack, Microsoft Teams ou Discord, ou para o seu servidor como webhook assinado. Escolha os eventos, envie um teste e confira o registro de entregas.
No Pro e no Team, o Pandafile pode avisar suas outras ferramentas na hora em que algo acontece: uma mensagem em um canal do Slack, Microsoft Teams ou Discord, ou um webhook, que é uma requisição HTTPS assinada para o seu próprio servidor.
Eventos que você pode escolher
- Transferência pronta: o envio terminou e o link já funciona.
- Transferência baixada: uma vez por destinatário, na primeira vez. Você pode escolher cada download no lugar disso.
- Transferência expirada.
- Aprovação ou pedido de alterações de um destinatário.
- Envio para um dos seus pedidos de arquivos.
- Documento assinado por todos, no Pandafile Sign.
Adicionar uma integração
- No Slack, Microsoft Teams ou Discord, crie um webhook de entrada para o canal e copie a URL. Para o seu próprio sistema, use um endereço HTTPS no seu servidor.
- Entre no Pandafile e abra Painel > Integrações.
- Em Adicionar uma integração, escolha o tipo, cole a URL, dê um nome se quiser e marque os eventos que você quer.
- Clique em Adicionar integração e depois em Enviar evento de teste para conferir se ele chega.
Você pode ter até 5 integrações. As mensagens de chat são escritas no idioma da sua conta.
Webhooks para desenvolvedores
- Cada entrega é um POST JSON com o tipo de evento, um id e os detalhes: ids, títulos, links, contagens e e-mails dos destinatários. Nunca inclui o conteúdo dos arquivos, senhas ou links de download pessoais.
- Toda requisição tem um cabeçalho Pandafile-Signature com um carimbo de tempo (t) e uma assinatura HMAC-SHA256 (v1) do carimbo de tempo e do corpo, feita com o seu segredo de assinatura. O segredo começa com whsec_ e aparece só uma vez.
- Novo segredo cria um novo segredo de assinatura. O antigo continua valendo por 24 horas, para você trocar sem perder eventos.
- Responda com um status 2xx em até 10 segundos. Caso contrário, tentamos de novo depois de 1 minuto, 5 minutos, 30 minutos, 2 horas e 12 horas.
- O registro de entregas mostra as últimas 50 entregas de cada integração e o resultado delas.
Equipes, modo de teste e Zapier
Em uma equipe, cada pessoa gerencia as próprias integrações e recebe só os eventos das próprias transferências. Eventos de transferências de teste feitas com uma chave de API de teste vão para os webhooks com livemode como false, nunca para o Slack, Teams ou Discord. Zapier e Make se conectam pela API do Pandafile e aparecem em Assinaturas via API.