> ## Documentation Index
> Fetch the complete documentation index at: https://docs.opptima.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuración

> Dominios, SPF/DKIM, SMTP, suscripciones, categorías, webhooks, API y reportes programados.

La sección **Configuración** centraliza todos los ajustes de tu cuenta: dominios, autenticación de correo, páginas de suscripción, categorías, notificaciones (webhooks), claves de API y más.

## Dominios

Aquí configuras el dominio que usarás en tus campañas y los parámetros tipo **TXT** necesarios para que la plataforma funcione correctamente.

<Frame>
  <img src="https://mintcdn.com/opptima/sfc0L-OO50AQo4WX/images/configuracion/configuracion-01.png?fit=max&auto=format&n=sfc0L-OO50AQo4WX&q=85&s=a6775a7fb5c15c9ec07b1aeb9af8d46b" alt="Configuración de dominios" width="1175" height="601" data-path="images/configuracion/configuracion-01.png" />
</Frame>

* **Añadir dominio** — agrega tu dominio. Consulta el paso a paso en [Verificar tu dominio](/primeros-pasos/verificar-dominio).
* **Dominios disponibles** — listado de tus dominios y si están activos o no.

### SPF

El **registro SPF** evita que terceros falsifiquen tu dominio y envíen mensajes con tus direcciones de remitente. El servidor del destinatario consulta el SPF para verificar que el mensaje proviene de un servidor de correo autorizado.

### DKIM

**DKIM** (DomainKeys Identified Mail) añade una **firma digital** cifrada al correo, permitiendo al receptor verificar que fue enviado y autorizado por el propietario del dominio, y que su contenido no se modificó en el camino. Usado junto con SPF, mejora la entregabilidad y protege tu dominio. La validación se realiza a nivel de servidor.

## SMTP

Debes configurar un registro SPF (tipo **TXT**) incluyendo nuestros servidores; si ya tienes un SPF, añade nuestro servidor al existente.

<Frame>
  <img src="https://mintcdn.com/opptima/sfc0L-OO50AQo4WX/images/configuracion/configuracion-04.png?fit=max&auto=format&n=sfc0L-OO50AQo4WX&q=85&s=72360187a66a1b7566020ce8f77d2739" alt="Parámetros SMTP" width="1171" height="487" data-path="images/configuracion/configuracion-04.png" />
</Frame>

## Páginas de administración de suscripción

Agrega una página dedicada para que tus clientes administren sus suscripciones o filtren el tipo de correos que desean recibir de tu dominio.

<Frame>
  <img src="https://mintcdn.com/opptima/sfc0L-OO50AQo4WX/images/configuracion/configuracion-05.png?fit=max&auto=format&n=sfc0L-OO50AQo4WX&q=85&s=4be4c5c60c0e63500fd4498db2ced51b" alt="Páginas de administración de suscripción" width="1181" height="399" data-path="images/configuracion/configuracion-05.png" />
</Frame>

Al añadir una página puedes personalizar: **nombre**, **color de fondo**, **título** (texto o logo), **texto adicional** y **favicon** (tamaño recomendado 50×50 px).

## Categorías de campaña

Crea categorías para administrar las suscripciones de tus contactos según el tipo de campaña.

<Frame>
  <img src="https://mintcdn.com/opptima/sfc0L-OO50AQo4WX/images/configuracion/configuracion-08.png?fit=max&auto=format&n=sfc0L-OO50AQo4WX&q=85&s=00a9808e3c622e4e49599b887bc5eceb" alt="Categorías de campaña" width="1150" height="518" data-path="images/configuracion/configuracion-08.png" />
</Frame>

<Note>
  Si no hay categorías creadas, tus destinatarios solo podrán cancelar la suscripción **total** a los correos de tu dominio. Las categorías **no afectan** la entrega vía SMTP ni SMS.
</Note>

## Notificaciones (Webhooks)

Puedes recibir los eventos seleccionados en distintas URLs en formato **JSON**. Tu endpoint debe responder con código **200**; si se reciben múltiples errores, el webhook se desactiva.

<Frame>
  <img src="https://mintcdn.com/opptima/sfc0L-OO50AQo4WX/images/configuracion/configuracion-12.png?fit=max&auto=format&n=sfc0L-OO50AQo4WX&q=85&s=b3f4375f8f15a0305d3a9901e251f287" alt="Configuración de notificaciones y API" width="1172" height="362" data-path="images/configuracion/configuracion-12.png" />
</Frame>

Para configurarlo, agrega la URL (incluyendo `http://` o `https://`) y selecciona el evento que la activará.

<Card title="Documentación de Webhooks" icon="webhook" href="/webhooks/introduccion">
  Conoce los tipos de eventos disponibles y la estructura de cada payload.
</Card>

## API

Las **API** permiten que dos componentes de software se comuniquen mediante definiciones y protocolos. Desde aquí gestionas tus claves de acceso.

<Card title="Referencia de la API" icon="code" href="/api/introduccion">
  Consulta la autenticación y los endpoints disponibles.
</Card>

### Añadir clave

* **Nombre** — identifica tu clave.
* **Tipo de autenticación** — **Clave API (Bearer Token)**, que se muestra una sola vez al guardarla (guárdala en un lugar seguro), o **Usuario y contraseña (Basic Auth)** con tus credenciales de la plataforma.
* **Permisos** — define para qué servicio se usará: SMTP, SMS o WhatsApp.

### IP Whitelist

Direcciones IP permitidas para hacer peticiones a la API. Si **Permitir todas las IPs** está activado, la lista se ignora.

## Reportes programados

Configura una dirección de correo para recibir, semanalmente, un reporte de los mensajes enviados. Defines **email**, **día de la semana**, **hora** (formato 24h), **zona horaria** y el tipo de reporte.

<Frame>
  <img src="https://mintcdn.com/opptima/sfc0L-OO50AQo4WX/images/configuracion/configuracion-15.png?fit=max&auto=format&n=sfc0L-OO50AQo4WX&q=85&s=22db5fc07c48b5fad78e0f630344e925" alt="Reportes programados" width="1177" height="467" data-path="images/configuracion/configuracion-15.png" />
</Frame>

## E-mails encriptados

Puedes enviarnos los correos encriptados con **OpenPGP** y nosotros los enviamos desencriptados. Solo necesitas ingresar tu clave OpenPGP privada y guardar los cambios.

<Frame>
  <img src="https://mintcdn.com/opptima/sfc0L-OO50AQo4WX/images/configuracion/configuracion-17.png?fit=max&auto=format&n=sfc0L-OO50AQo4WX&q=85&s=e8de123e9b6fc8aed842d6bea8aca2b6" alt="Configuración de e-mails encriptados" width="946" height="497" data-path="images/configuracion/configuracion-17.png" />
</Frame>
