Saltar al contenido
Mailack
enAgenda una demo
Docs · Dominios

Dominios de envío.

Registra el dominio desde el que envías, publica el registro TXT de challenge y verifícalo antes de usarlo en el From.

  1. 01por qué

    Control del remitente

    Cuando un tenant tiene al menos un dominio verificado, el campo From de cada mensaje debe coincidir con un dominio verificado. Si no, la API responde domain_not_verified y el mensaje no entra a la cadena de evidencia.

    pendingverifieddomain_not_verified
  2. 02POST /v1/domains

    Registrar el dominio

    Crea el dominio en estado pending. La respuesta incluye el token de verificación y pistas DNS (challenge_host, challenge_value, dkim_host, spf_hint).

    POST /v1/domains
    curl -s -X POST "$MAILACK_API_URL/v1/domains" \
  -H "Authorization: Bearer $MAILACK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain":"mail.acme.mx"}' | jq .
  3. 03DNS

    Publicar el challenge TXT

    En la zona DNS del dominio, publica un registro TXT en challenge_host con el valor challenge_value. Propaga el registro y espera a que sea visible desde Internet.

    tipoTXT
    hostchallenge_host (respuesta de create)
    valorchallenge_value

    También puedes hacerlo desde el portal del cliente: Dominios → crear → copiar registros → Verificar.

  4. 04POST /v1/domains/{id}/verify

    Verificar

    Mailack consulta DNS y, si el TXT coincide, marca el dominio como verified. Puedes reintentar si la propagación aún no ha terminado.

    POST /v1/domains/{id}/verify
    curl -s -X POST "$MAILACK_API_URL/v1/domains/$DOMAIN_ID/verify" \
  -H "Authorization: Bearer $MAILACK_API_KEY" | jq .
  5. 05DNS · firma

    «Falta DKIM»: el dominio es tuyo, pero todavía no firma

    La verificación acredita la propiedad; el DKIM firma cada mensaje. Si el portal muestra «Falta DKIM», el dominio está verificado pero el registro de firma no está publicado: el correo sale igual, pero sin firma alineada y con más probabilidad de acabar en spam. Para solucionarlo, publica el registro DKIM que aparece en el portal (Dominios → tu dominio → Registros DNS) y pulsa «Comprobar DKIM».

    verifiedFalta DKIM
    tipodkim_record_type (habitualmente CNAME)
    hostdkim_host
    valordkim_value

    Copia host y valor tal cual, sin añadir ni quitar nada. La propagación tarda desde unos minutos hasta unas horas; después, «Comprobar DKIM» confirma que el dominio ya firma.

  6. 06scopes

    Autenticación

    Las rutas machine usan API key Bearer. Crear y verificar requieren messages:send; listar requiere evidence:read. Equivalentes de portal: /v1/portal/domains.

    messages:sendevidence:read

Siguiente: webhooks

Cuando el dominio esté verificado, conecta endpoints HTTPS para recibir el lifecycle del mensaje.

Guía de webhooks