API de correo postal: envía cartas personalizadas desde tu propio software
Con la API de Yotru, tu CRM, tu tienda online o tu sistema de reservas envía por sí solo cartas impresas y personalizadas. Creas una carta, añades destinatarios y apruebas. No necesitas un diseño: Yotru construye la carta a partir de tu web, en español. Cada carta lleva el nombre del destinatario y su propio código QR, así ves exactamente quién responde.
Lo que obtienes
- Sin trabajo de diseño
- Envía la dirección de tu web y Yotru construye la carta con tu logo y tus colores. O elige una plantilla y envía tu propio texto.
- Personal para cada destinatario
- Cada carta lleva el nombre del destinatario, su propio código QR y su propia página de destino. Puedes añadir campos propios por destinatario.
- Ves quién responde
- Cada escaneo pertenece a un solo destinatario. Lo ves en tu panel y puedes recibir un aviso por correo o en Slack al momento.
- Gratis para construir y probar
- Crear cartas, pedir vistas previas y añadir destinatarios no cuesta nada. Pagas cuando apruebas una campaña.
- Revisado antes de imprimir
- Después de tu aprobación, una persona de nuestro equipo revisa el lote antes de que vaya a imprenta.
- Impresión y franqueo incluidos
- Un solo precio por carta para el diseño, la impresión, el sobre y la entrega.
Cómo funciona
| Paso | Llamada | Qué pasa |
|---|---|---|
| 1 | POST /v1/cards | Creas una carta, con product, country y language. Lo que no envíes sale de la plantilla o se lee de tu web. |
| 2 | POST /v1/recipients | Añades hasta 1.000 destinatarios por llamada. La primera llamada abre una campaña sola. |
| 3 | POST /v1/campaigns/{id}/approve | Apruebas. La respuesta trae un enlace de pago, y la campaña pasa a imprenta en cuanto se paga. |
curl -X POST https://api.yotru.com/v1/cards \
-H "Authorization: Bearer $YOTRU_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Oferta de otoño","product":"letter","country":"ES","website":"https://ejemplo.es"}'
curl -X POST https://api.yotru.com/v1/recipients \
-H "Authorization: Bearer $YOTRU_KEY" \
-H "Content-Type: application/json" \
-d '{"cardId":"CARD_ID","recipients":[{"name":"Ana García","street":"Calle Mayor","houseNumber":"1","postcode":"28013","city":"Madrid","country":"ES"}]}'Una llamada de vista previa devuelve la carta tal y como se imprimirá, para que la revises antes de aprobar.
Qué puedes construir
- Cartas para recuperar clientes. Tu tienda escribe a los clientes que llevan seis meses sin comprar.
- Aniversarios y renovaciones. Tu CRM envía una carta cuando alguien cumple un año como cliente.
- Seguimiento. Tu sistema de reservas envía una carta después de una primera visita o de una cita perdida.
- Correo para tus propios clientes. Tu software ofrece cartas a sus usuarios, y tú eres el remitente ante nosotros.
Cuánto cuesta
El mismo precio por carta que un pedido hecho en la web, con impresión, sobre y franqueo incluidos. Una carta a España cuesta 2,49 € por unidad con 100 y 1,35 € con 5.000, sin IVA. No hay mínimo: por debajo de 100 cartas, cada una cuesta el precio de 100. Crear y probar es gratis.
Bueno saberlo antes de empezar
- Las cartas llegan a los 16 países, entre ellos España, Francia y Alemania. Las postales se imprimen para Alemania, el Reino Unido, los Países Bajos, Canadá y Estados Unidos.
- Las cartas se construyen con cuatro plantillas que rellenas con tu texto, tus colores, tu logo y tu foto.
- Una carta va a un país, donde viven sus destinatarios. Caben hasta 1.000 destinatarios en una llamada, y con una cabecera Idempotency-Key una llamada repetida es segura.
Preguntas sobre la API
- ¿Hay modo de prueba o sandbox?
- No, y no lo necesitas. Crear cartas, pedir vistas previas y añadir destinatarios no cuesta nada ni envía nada. Solo aprobar una campaña cuesta dinero.
- ¿Cómo consigo una clave de API?
- Crea una cuenta y abre Ajustes, luego Integraciones y Claves de API. Tu primera clave se crea al abrir esa página y se muestra una sola vez. Tienes que ser propietario o administrador y haber confirmado tu correo.
- ¿La carta se escribe en español?
- Sí. Una carta a España se escribe en español si no indicas otra cosa. Con language eliges otro de los diez idiomas.
- ¿Puede llevar algo impreso en el reverso?
- Sí. Con backSide: true imprimimos una segunda página en el reverso, por 0,25 € más por carta.
- ¿Qué pasa con una dirección incorrecta?
- Ese destinatario se rechaza con un motivo, como address o duplicate, y el resto de la lista sigue adelante.
- ¿Hay límites de llamadas?
- Cada clave puede hacer 120 llamadas por minuto y 300 al día que crean o cambian cartas o envían fotos.
- ¿Puedo ver quién responde a una carta?
- Sí. Cada carta tiene su propio código QR, así que cada escaneo pertenece a un destinatario. Lo ves en tu panel y puedes recibir un aviso al momento.
- ¿Funciona con mi CRM o mi tienda?
- Cualquier sistema que pueda hacer una llamada HTTPS puede usar la API. Si usas HubSpot, también puedes conectar tus listas sin código desde el panel.
Por qué la construimos así: API para enviar cartas: manda cartas personalizadas desde tu propio software.