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

  1. Abra Integrações no seu painel, clique em Adicionar uma integração e escolha Webhooks.
  2. Informe a URL do seu endpoint. Ela precisa começar com https:// e estar acessível pela internet.
  3. Opcional: adicione os cabeçalhos que o seu endpoint espera, por exemplo um cabeçalho Authorization.
  4. Escolha a enquete e se quer enviar as respostas novas, as alteradas ou ambas, e salve.
  5. Copie o Segredo de assinatura na página da integração e clique em Enviar teste.

O payload

json
{
	"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.deleted ou ping no Enviar teste.
  • Em response.deleted, deletedAt informa quando o participante excluiu a resposta, e answers traz 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.
  • answers lista 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çalhoO que contém
X-StrawPoll-EventO evento, por exemplo response.created
X-StrawPoll-DeliveryO id da entrega
X-StrawPoll-TimestampQuando foi enviado, em segundos Unix
X-StrawPoll-Signaturesha256= 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:

js
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.