muralvivoWebhook a cada aprovação
O momento que a integração realmente importa: quando um depoimento pendente vira prova social. Cada aprovação dispara um POST com o depoimento completo. Reprovados e pendentes nunca disparam.
integrações
Depoimentos aprovados, direto no seu CRM .
A integração que o seu stack já entende: um webhook disparado a cada aprovação e um feed JSON com o que está no mural. Zapier, Make, n8n, HubSpot. Qualquer automação consome, sem conector nativo.
Funciona com Zapier, Make e n8n
Nenhum conector nativo para construir ou manter. Cole a URL do webhook nas configurações e a automação existente do seu stack passa a receber os depoimentos no formato que ela já espera.
Assinatura HMAC em toda entrega
Cada chamada chega com o header X-Muralvivo-Signature. HMAC-SHA256 do corpo com o segredo da sua conta. Você verifica que a entrega veio do Muralvivo e não foi adulterada no caminho.
Feed JSON pronto para consumir
Endpoint somente leitura com os depoimentos aprovados e no mural, mais recentes primeiro. Reusa a chave do seu widget; quem já usa o embed não configura nada novo.
Histórico de entregas no painel
Cada tentativa fica registrada: evento, status HTTP e erro. Se o destino cair, você vê a falha, corrige e o próximo depoimento aprovado segue o fluxo.
Só conteúdo aprovado, sempre
Pendentes e reprovados nunca saem do Muralvivo, nem pelo webhook, nem pelo feed. O que você revisou e aprovou é exatamente o que a integração recebe.
O que o webhook envia
Um POST em JSON a cada aprovação, assinado com HMAC-SHA256. O destino recebe exatamente o que você revisou.
{
"event": "testimonial.approved",
"testimonial": {
"id": "cl9x8...",
"type": "text",
"text": "Adorei o produto!",
"authorName": "Marta Oliveira",
"authorCompany": "Órbita",
"rating": 5,
"tags": ["pós-compra"],
"createdAt": "2026-08-04T18:03:00.000Z"
},
"space": { "id": "spc_1", "name": "Órbita" }
}Como funciona
Três passos entre o painel e a sua automação, sem código para escrever no Muralvivo.
01
Cole a URL de destino
Em Painel → Integrações, cole a URL do webhook do seu CRM, do Zapier, do Make ou do n8n. Nada mais a configurar.
02
Aprove um depoimento
O fluxo de revisão não muda: você continua aprovando e reprovando no painel. A aprovação é o gatilho, só ela.
03
Sua automação recebe e age
O depoimento chega em JSON com nome, empresa, texto, nota e data. O destino cria o registro, manda pro e-mail ou posta onde você quiser.
O que exatamente o webhook envia?
Um POST com Content-Type application/json. O corpo traz o evento (testimonial.approved), o depoimento completo (id, texto, nome do autor, empresa, nota, tags, consentimento e data) e os dados do espaço. O cabeçalho X-Muralvivo-Signature assina o corpo com HMAC-SHA256.
Como faço para verificar a assinatura?
Calcule HMAC-SHA256 do corpo bruto da requisição usando o segredo que aparece no painel (em Integrações) e compare com o header X-Muralvivo-Signature. Se bater, a chamada veio do Muralvivo e não foi alterada. No Zapier, use um Webhook customizado e confira os headers na aba de configuração.
O que acontece se o meu endpoint estiver fora do ar?
O Muralvivo tenta de novo: até 3 tentativas com intervalos curtos (imediata, 1s e 5s) para falhas de rede e erros 5xx. Erros 4xx não são repetidos; o destino rejeitou o payload e continuará rejeitando. Toda tentativa fica registrada no histórico de entregas do painel.
O feed JSON expõe depoimentos pendentes?
Não. O feed devolve somente depoimentos aprovados e marcados para aparecer no mural. A chave na URL (a mesma do widget) é o segredo de acesso: quem não tem a chave recebe 404.
Preciso de um plano específico para usar as integrações?
Não. Webhook e feed JSON estão disponíveis em todos os planos ativos, sem custo adicional. Basta entrar no painel e configurar.
Funciona com vídeo e áudio?
Sim. O payload inclui o tipo do depoimento e, para vídeo e áudio, a URL pública do arquivo. Você decide no destino o que fazer com o arquivo, e o texto transcrito também vai no payload quando existir.