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

# Missatges als clients

> Previsualitza missatges predefinits, demana informació a un contacte verificat i revisa les respostes dels clients a Didit.

Obre un cas i tria **Enviar missatge**.
Tria un destinatari verificat, un idioma i la finalitat, i després selecciona **Previsualització**.
La previsualització mostra el remitent, el destinatari, l'assumpte i el cos del correu electrònic exactes.
Tria **Edita** per canviar la selecció, o **Envia** per confirmar-la.
Una previsualització modificada o caducada s'ha de tornar a generar abans d'enviar-la.

## Finalitats dels missatges

| Finalitat | Acció del client | Estat del cas |
| - | - | - |
| Document d'identitat | Puja una fotografia nítida d'un document d'identitat | Esperant l'usuari |
| Comprovant de domicili | Puja un document recent que mostri el nom i l'adreça de residència | Esperant l'usuari |
| Document d'empresa | Puja un document d'inscripció de l'empresa | Esperant l'usuari |
| Confirma les dades | Envia un nom complet i una data de naixement perquè el revisor els valori | Esperant l'usuari |
| Revisió en curs | No cal cap acció; el correu no conté cap botó de resposta | Sense canvis |

Les pujades de documents accepten actualment imatges JPEG, PNG i WebP de fins a 5 MB.
Només apareixen les finalitats aplicables al subjecte del cas.
Les plantilles de correu electrònic per al client estan disponibles actualment en anglès, castellà i portuguès.
La consola utilitza el mateix camp de correu electrònic i el mateix selector d'idioma que la repetició de les sessions de verificació.

## Destinataris verificats i plantilles fixes

Un destinatari ha d'haver completat la verificació de correu electrònic en una sessió que pertanyi al subjecte i a l'aplicació del cas.
Una adreça importada o editada en un perfil d'usuari no acredita la verificació.
Si no hi ha cap contacte verificat, el redactor ho explica i l'enviament queda desactivat.

Els revisors no poden subministrar text de correu electrònic, enllaços, adreces de remitent ni destinataris arbitraris.
El correu utilitza la imatge de marca existent de Didit o de marca blanca.
Un remitent personalitzat requereix que el domini de correu configurat estigui verificat.
Cada plantilla indica al destinatari que el correu no demanarà contrasenyes, codis de verificació ni pagaments.

La repetició de les sessions de verificació continua sent una acció independent per repetir les comprovacions de verificació.
La seva previsualització mostra el correu de repetició real i les comprovacions seleccionades.

## Lliurament i respostes

L'historial de missatges distingeix els resultats de lliurament en cua, en procés d'enviament, enviat, simulat i desconegut.
Un correu simulat no s'envia.
Un resultat desconegut vol dir que el proveïdor podria haver acceptat el correu; el sistema no el torna a enviar automàticament.
Reintentar una sol·licitud confirmada utilitza el mateix ID de sol·licitud per evitar lliuraments duplicats.

Una sol·licitud que requereix una acció té un enllaç de resposta segur vàlid durant set dies.
Cancel·lar la sol·licitud o resoldre el cas invalida aquest enllaç, fins i tot després que el cas es reobri.
La pàgina del client no revela les conclusions privades del cas ni altres registres d'origen.

Una resposta enviada apareix a **Missatges al client** com a evidència pendent de revisió.
El cas torna a Obert, i una resolució pendent existent s'ha de revisar de nou.
Les respostes no poden substituir una presentació anterior, aprovar la verificació original, sobreescriure la identitat d'un client ni contribuir a un resultat de frau.

Eliminar la verificació d'origen o el cas elimina les seves sol·licituds al client i les evidències pujades.

## Flux de treball de l'API

Tots els endpoints de la consola estan limitats a una organització, una aplicació i un cas:

```text theme={null}
GET  /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/requests/options/
POST /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/requests/preview/
GET  /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/requests/
POST /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/requests/
POST /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/requests/{request_uuid}/cancel/
POST /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/requests/{request_uuid}/remind/
GET  /v3/organization/{organization_id}/application/{application_id}/cases/{case_uuid}/requests/{request_uuid}/attachment/
```

Llegir l'historial i els adjunts requereix `read:cases`.
Redactar, previsualitzar, confirmar, cancel·lar i enviar recordatoris requereix `write:cases`.
La confirmació ha d'incloure el mateix `contact_id`, `purpose` i `language`, a més del `request_id`, `expires_at` i `preview_token` que retorna la previsualització.
El justificant de confirmació caduca als 15 minuts, de manera independent del termini de resposta del client.

Un recordatori envia el mateix correu de nou al mateix destinatari verificat, com a màxim una vegada per sol·licitud cada 24 hores.
No canvia res més: la sol·licitud manté el seu termini i el cas manté el seu estat.
La resposta retorna la sol·licitud, `reminded_at`, el `delivery_status` del propi recordatori (`SENT`, `SIMULATED` o `UNKNOWN`) i `next_reminder_at`.
Una sol·licitud que el client ja no ha de respondre retorna `409` amb `code` `case_request_not_waiting` i un `reason`: `answered`, `cancelled`, `expired`, `closed`, `not_actionable`, `not_delivered` o `contact_unavailable`.
Un segon recordatori dins de les 24 hores retorna `429` amb `code` `case_request_reminder_too_soon`, una marca de temps `retry_at` i una capçalera `Retry-After`.
Mentre una resolució espera aprovació, un recordatori retorna `400`.

L'endpoint del client és `GET` o `POST /v3/case-requests/{request_uuid}/` amb la capçalera `X-Case-Request-Token` específica de la sol·licitud.
L'enllaç de resposta porta aquesta credencial al fragment; la pàgina elimina el fragment en obrir-se.
El token només dona accés a aquesta sol·licitud.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.