Voz de correo del workspace
Lo que un asistente debe leer antes de escribir un correo a nombre del workspace: idioma, guía de estilo, la persona del agente de IA y correos recientes reales del equipo.
Descarga la proyección completa de la API pública: openapi.json.
Escribir correos con un asistente explica este recurso en prosa, con ejemplos ejecutables.
| Método | Ruta | Qué hace |
|---|---|---|
GET | /copilot/email-voice | The workspace's email voice — read it before writing an email |
GET /copilot/email-voice
The workspace's email voice — read it before writing an email
Everything an AI needs to write an email that sounds like THIS workspace, in one read and with no model call: the workspace language (locale), its written style guide, the persona of the AI agent that serves its email (agent_instructions — take its tone, ignore its channel mechanics), up to five real emails people of the workspace recently sent (quoted history and signatures stripped, each capped at ~1,200 characters), the caller's default signature, and — with contact_id — the recipient.
If you are a user's own assistant connected through the Vitrina MCP, call this before drafting an email, write in locale, imitate the sample emails (never copy their facts), then save the result with POST /email-drafts for a person to review and send. Leave the signature out of the body: it is appended when the person sends.
The voice is the WORKSPACE's, not a member's: most human replies are typed straight into the connected mailbox, so the samples are the team's mail, not the caller's.
| Parámetro | En | Tipo | Obligatorio | Restricciones |
|---|---|---|---|---|
contact_id | query | uuid | no |
curl https://api.vitrinadev.com/api/v1/copilot/email-voice \
-H "Authorization: Bearer $VITRINA_KEY"Ejemplo de respuesta (200)
{
"data": {
"locale": "es",
"style_guide": "Cercano y claro. Tuteamos. Frases cortas. Nunca prometemos plazos que no controlamos.",
"agent_instructions": "Eres el asistente del equipo. Respondes con calidez y precisión, tuteas y cierras siempre con un próximo paso concreto.",
"agent": {
"id": "33333333-0000-4000-8000-000000000001",
"name": "Asistente"
},
"sample_emails": [
{
"subject": "Tu cotización",
"body_text": "Hola Pedro,\n\nTe adjunto la cotización que conversamos. Cualquier duda me escribes por aquí o al WhatsApp.\n\nUn abrazo,",
"sent_at": "2026-09-20T13:40:00.000Z"
}
],
"signature": {
"id": "44444444-0000-4000-8000-000000000001",
"name": "Firma principal",
"text": "Persona del equipo\nEquipo comercial"
},
"contact": {
"id": "22222222-0000-4000-8000-000000000001",
"name": "María González",
"email": "[email protected]"
}
}
}Responde: 200 · 400 · 401 · 403 · 404 · 409 · 429