Webhooks y API

Testivora tiene dos formas de conectarse con tus herramientas: webhooks para reaccionar en tiempo real y una API REST para leer y escribir bajo demanda. Esta guía explica cuál usar en cada caso.

Lectura · ~5 min

Las dos superficies

Webhooks = Testivora te avisa (push). La API = tú le preguntas a Testivora (pull). La mayoría de las automatizaciones usan una de las dos; algunas usan ambas. Las dos viven en Ajustes y requieren plan Growth o Agency.

Webhooks — para reaccionar en tiempo real

Un webhook es una URL HTTPS tuya a la que Testivora manda un POST en cuanto pasa algo. Regístrala en Ajustes → Webhooks → Nuevo endpoint, elige los eventos y guarda; recibes un secret whsec_… para verificar la firma. Hay tres eventos: testimonial.created (llega un testimonio nuevo), testimonial.approved (lo apruebas) y testimonial.deleted (se elimina). Cada POST llega con este sobre — el testimonio vive dentro de data:

json

{
  "id": "evt_3hF2bQ...",
  "object": "event",
  "event": "testimonial.approved",
  "version": "1.0",
  "created": "2026-06-03T01:00:00.000Z",
  "attempt": 1,
  "data": {
    "id": "j97...",
    "type": "text",
    "status": "approved",
    "rating": 5,
    "text": "Cerré 3 clientes en una semana.",
    "featured": false,
    "tags": ["onboarding"],
    "author": {
      "name": "Ana López",
      "title": "Coach",
      "company": "Acme",
      "photo_url": "https://...",
      "social": "https://instagram.com/ana"
    },
    "video": null,
    "created_at": "2026-06-03T00:59:50.000Z",
    "published_at": "2026-06-03T01:00:00.000Z"
  }
}

El id (evt_…) es estable entre reintentos: úsalo para no duplicar. Para testimonial.deleted, data = { id, object: "testimonial", space_id, deleted: true }.

La API REST — para leer y escribir bajo demanda

Cuando quieres consultar tus datos cuando a ti te conviene (no esperar a un evento), usa la API REST. Crea una API key en Ajustes → API (empieza con tv_live_…) y mándala como Bearer token. La base es https://api.testivora.com. Lo más común es leer testimonios; también puedes crearlos y editarlos:

bash

# Lista los testimonios de un espacio
curl https://api.testivora.com/v1/testimonials?space_id=spc_123 \
  -H "Authorization: Bearer tv_live_..."

# Crear o actualizar también van por la misma base:
#   POST  /v1/testimonials          (crea uno)
#   PATCH /v1/testimonials/{id}      (edita uno)
#   GET   /v1/spaces  /v1/walls  /v1/account

Endpoints disponibles: /v1/testimonials (GET/POST/PATCH), /v1/spaces, /v1/walls y /v1/account. Documentación completa en /docs/api.

¿Cuál uso?

Usa webhooks cuando tu acción es una reacción a un evento: etiquetar un contacto en tu CRM, mandar una alerta a Slack, agregar una fila a una hoja en cuanto entra un testimonio. Es push, sin que tengas que preguntar. Usa la API cuando tú decides el momento: mostrar testimonios en tu propio sitio, sincronizar tu base cada noche, exportar todo para un reporte. Es pull, bajo tu control. Regla simple: ¿reaccionar a algo que acaba de pasar? webhook. ¿traer datos cuando te convenga? API.

Plan requerido

Tanto los webhooks como la API están disponibles solo en los planes Growth y Agency. Si no ves las secciones en Ajustes, revisa tu plan.

Siguiente paso

Para conectar webhooks sin código, sigue las recetas de herramientas (n8n, Zapier, Make) en /docs/automate. Para la referencia completa de la API REST, ve a /docs/api.