Desenvolvedores
Enviar as respostas para o seu servidor com webhooks
Receba cada resposta como um payload JSON assinado, e confirme que ele veio mesmo do StrawPoll.
Última atualização
Um webhook envia cada resposta para um endereço no seu próprio servidor, como uma requisição POST com um corpo JSON.
Configurar
- Abra Integrações no seu painel, clique em Adicionar uma integração e escolha Webhooks.
- Informe a URL do seu endpoint. Ela precisa começar com
https://e estar acessível pela internet. - Opcional: adicione os cabeçalhos que o seu endpoint espera, por exemplo um cabeçalho
Authorization. - Escolha a enquete e se quer enviar as respostas novas, as alteradas ou ambas, e salve.
- Copie o Segredo de assinatura na página da integração e clique em Enviar teste.
O payload
{
"id": "0193f1c2-…",
"event": "response.created",
"createdAt": "2026-11-08T14:05:12.000Z",
"form": {
"id": "…",
"slug": "almoco-da-equipe",
"name": "Almoço da equipe",
"title": "Onde vamos comer na sexta?",
"url": "https://strawpoll.com/…"
},
"response": {
"id": "…",
"createdAt": "2026-11-08T14:05:11.000Z",
"updatedAt": null,
"deletedAt": null,
"respondent": { "name": "Sam", "email": "sam@example.com", "phone": null },
"answers": [
{
"fieldId": "…",
"question": "P1 · Onde vamos comer?",
"value": "…",
"text": "Pizza"
}
],
"comment": null
}
}eventéresponse.created,response.updated,response.deletedoupingno Enviar teste.- Em
response.deleted,deletedAtinforma quando o participante excluiu a resposta, eanswerstraz o que ele tinha enviado. Exclua a resposta dos seus próprios registros também. idé único para cada entrega. Use-o para ignorar uma entrega que você já processou.answerslista todas as perguntas, em ordem.texté a resposta como aparece nos seus resultados;valueé o valor bruto, cujo formato depende do tipo de pergunta.
Cabeçalhos
| Cabeçalho | O que contém |
|---|---|
X-StrawPoll-Event | O evento, por exemplo response.created |
X-StrawPoll-Delivery | O id da entrega |
X-StrawPoll-Timestamp | Quando foi enviado, em segundos Unix |
X-StrawPoll-Signature | sha256= seguido da assinatura |
Verificar a assinatura
A assinatura é um HMAC-SHA256, gerado com o seu segredo de assinatura, do ID da entrega, do timestamp e do corpo bruto da requisição, unidos por pontos. Calcule-a você mesmo e compare:
import { createHmac, timingSafeEqual } from 'node:crypto';
function isFromStrawPoll(request, rawBody, secret) {
const id = request.headers['x-strawpoll-delivery'];
const timestamp = request.headers['x-strawpoll-timestamp'];
const signature = request.headers['x-strawpoll-signature'] ?? '';
const expected =
'sha256=' + createHmac('sha256', secret).update(`${id}.${timestamp}.${rawBody}`).digest('hex');
const fresh = Math.abs(Date.now() / 1000 - Number(timestamp)) < 300;
return (
fresh &&
signature.length === expected.length &&
timingSafeEqual(Buffer.from(signature), Buffer.from(expected))
);
}Assine o corpo exatamente como ele chegou, antes de fazer o parse. Rejeitar timestamps antigos impede que alguém reenvie uma requisição interceptada.
Se o seu segredo pode ter vazado, clique em Renovar na página da integração. O segredo antigo para de funcionar na hora, então atualize o seu endpoint.
Responder a tempo
Responda com qualquer status 2xx em até 10 segundos. Deixe o processamento demorado para depois de responder.
Quando uma entrega falha, o StrawPoll tenta de novo três vezes ao longo do meio minuto seguinte, com o mesmo id. Ele não tenta de novo após uma resposta 4xx diferente de 429 e nunca segue redirecionamentos. Cada tentativa aparece em Entregas recentes, com o que o seu servidor respondeu.