Como enviar os RSVPs, check-ins e fotos do seu evento para outros apps
Os webhooks permitem que o seu evento avise outros apps do que está acontecendo no instante em que acontece. Quando um convidado responde ao RSVP, faz check-in na entrada ou uma nova foto aparece na galeria, a Fotify envia uma pequena mensagem para um endereço que você escolhe. De lá, ela pode chegar ao seu CRM, a uma planilha do Google, a um canal do Slack, a uma sequência de e-mails ou ao seu próprio servidor.
Você pode se conectar de duas formas:
- Zapier ou Make, sem código: conecte com uma chave de API e escolha o que deve acontecer.
- Uma URL de webhook sua: a Fotify envia para ela uma mensagem JSON assinada.
Webhooks, Zapier e Make estão incluídos a partir do plano Professional e em todos os eventos que funcionam com uma assinatura de evento.
O que a Fotify pode enviar
Cada webhook escuta um ou mais destes momentos:
- RSVP recebido: um convidado respondeu ou alterou o RSVP. Inclui nome, e-mail, telefone, resposta, tamanho do grupo, comentários e as respostas às suas perguntas personalizadas.
- Check-in do convidado: um convidado fez check-in na entrada, com o grupo e a pessoa que chegou.
- Nova foto ou vídeo: algo novo apareceu na galeria. As fotos vêm com um link para a imagem que funciona por 7 dias. As fotos aguardando aprovação são enviadas assim que você as aprova, e as fotos de álbuns privados nunca são enviadas.
- Evento iniciado: você iniciou o evento e os convidados podem enviar fotos.
- Evento encerrado: você encerrou o evento, ou o prazo de envio terminou.
Passo 1: conecte o Zapier ou o Make
- No painel da Fotify, abra Configurações da conta → Integrações.
- Digite um nome para a chave, por exemplo "Zapier", e clique em Criar chave.
- Copie a chave imediatamente. Por segurança, ela é mostrada apenas uma vez.
- Abra o app Fotify no Zapier ou no Make por estes links (ele ainda não está listado nos diretórios de apps deles) e cole a chave quando ele pedir para conectar.
- Escolha um gatilho, como Nova resposta de RSVP ou Nova foto ou vídeo, e selecione o seu evento na lista.
A lista de eventos mostra os eventos que você gerencia cujo plano inclui webhooks. Cada Zap ou cenário que você ativa aparece na página Webhooks do evento, marcado como Zapier ou Make.
Você também pode usar o Webhooks by Zapier → Catch Hook do Zapier ou o Custom webhook do Make em vez do app Fotify: copie o endereço que eles fornecem e adicione-o como URL de webhook no Passo 2.
Passo 2: adicione uma URL de webhook
- Abra o seu evento no painel e role até o cartão Webhooks, Zapier e Make.
- Clique em Configurar webhooks e depois em Adicionar um webhook.
- Cole o endereço que deve receber as mensagens. Ele deve começar com
https://e estar acessível pela internet. - Marque o que enviar, adicione um rótulo se quiser e clique em Adicionar webhook.
- Copie o segredo de assinatura mostrado acima do novo webhook e guarde-o no seu receptor.
- Clique em Enviar evento de teste para verificar se tudo chega.
Somente quem pode gerenciar o evento pode adicionar ou alterar os webhooks, e cada momento exige acesso aos seus dados: os momentos de convidados exigem acesso à lista de convidados, e os de fotos exigem acesso à galeria.
Como é uma mensagem
Cada mensagem é um POST com um corpo JSON:
{
"id": "4f1c2e9a-7b2d-4c1e-9a8f-2d3b4c5e6f70",
"type": "rsvp.responded",
"createdAt": "2026-06-01T18:24:05.000Z",
"event": { "id": "…", "name": "Ana & Leo's Wedding" },
"data": {
"rsvp": {
"firstName": "Alex",
"lastName": "Rivera",
"email": "alex@example.com",
"status": "accepted",
"confirmedGuests": 2
}
}
}
O status de um RSVP é um destes: accepted, declined, not_answered, attended, pending_approval (aguardando a sua aprovação) ou waitlisted. Um convidado aguardando aprovação ou na lista de espera tem confirmedGuests igual a 0 e o grupo que solicitou em requestedGuests; rsvp.responded é disparado novamente quando você o aprova ou recusa.
O id permanece o mesmo quando uma mensagem é reenviada, para que o seu receptor possa ignorar duplicatas. Os cabeçalhos indicam o momento (Fotify-Event) e a mensagem (Fotify-Delivery).
As datas do próprio evento, como eventDate e eventTime, são dadas no fuso horário do local, do jeito que os seus convidados as veem.
Verifique se uma mensagem veio da Fotify
Cada mensagem traz um cabeçalho Fotify-Signature como t=1780000000,v1=5257a8…. Para verificá-lo:
- Pegue
t(o momento do envio) e o corpo bruto da requisição. - Calcule um HMAC-SHA256 de
t+.+ corpo, usando o segredo de assinatura do seu webhook. - Compare o resultado com
v1e rejeite mensagens cujottenha mais de 5 minutos.
Em Node.js:
const crypto = require("crypto");
function isFromFotify(rawBody, header, secret) {
const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
const expected = crypto
.createHmac("sha256", secret)
.update(`${parts.t}.${rawBody}`)
.digest("hex");
const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;
return fresh && crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1));
}
Você pode mostrar o segredo novamente ou criar um novo no cartão do webhook. Um novo segredo substitui o antigo imediatamente.
Novas tentativas, registro de entregas e webhooks que se desativam
- Responda com um status 2xx em até 10 segundos para confirmar uma mensagem.
- As mensagens com falha são reenviadas 8 vezes ao longo de cerca de 4 horas.
- O registro de entregas de cada webhook mostra todas as mensagens dos últimos 30 dias, com o estado, a resposta e o corpo completo. Clique em Enviar novamente para reenviar uma.
- Um webhook se desativa sozinho quando a URL falha 50 vezes seguidas, quando o receptor responde
410 Gone(é assim que o Zapier e o Make avisam que um Zap ou cenário foi excluído) ou quando quem o adicionou perde o acesso ao evento. O cartão dele explica o motivo. Reative-o quando o problema for corrigido: você passa a ser a pessoa em nome de quem ele age.
Configure webhooks com um assistente de IA
Se você conectou um assistente de IA como o Claude, pode pedir que ele liste os webhooks do seu evento, adicione um, envie um teste ou exclua um. Ele precisa da URL que você fornecer e mostra o segredo de assinatura uma única vez.
Perguntas frequentes
P: Qual plano eu preciso? R: Webhooks, Zapier e Make estão incluídos a partir do plano Professional e em toda assinatura de evento. Nos outros planos, o cartão de Webhooks indica o plano que os inclui.
P: Preciso de uma conta no Zapier ou no Make? R: Sim, para usar o Zapier ou o Make você precisa de uma conta neles. Os webhooks para a sua própria URL não precisam de nada além disso.
P: Quantos webhooks um evento pode ter? R: Até 25, contando os que o Zapier e o Make criam.
P: Por que uma foto não chegou ao meu webhook? R: As fotos são enviadas quando aparecem na galeria. Uma foto aguardando aprovação é enviada assim que você a aprova, e as fotos de álbuns privados nunca são enviadas.
P: Posso usar uma URL do meu próprio computador para testar?
R: Não. A Fotify só envia para endereços públicos https://. Use um serviço de túnel, ou um inspetor de requisições, para testar a partir do seu computador.
P: O que acontece com os meus webhooks se eu revogar uma chave de API? R: O Zapier e o Make deixam de poder criar ou remover assinaturas com essa chave. Exclua as assinaturas que não quer mais na página Webhooks do evento.
Este artigo foi útil?