Cómo recuperar la configuración de envío de correo en Zoho

Recuperar la configuración de envío de correo en Zoho CRM es sencillo a través de un único endpoint de la API de configuración que devuelve la configuración de correo saliente de tu organización.

Por qué esto es importante

Cuando necesitas auditar, solucionar problemas o inspeccionar de forma programática cómo están configurados los correos salientes en Zoho CRM, necesitas una forma fiable de obtener esos datos sin navegar por múltiples pantallas de la interfaz. Esto es especialmente útil para consultores que incorporan a un nuevo cliente, desarrolladores que crean integraciones o administradores que verifican que la identidad de envío correcta está en uso. Comprender la llamada a la API también te permite automatizar las comprobaciones de configuración como parte de un flujo de trabajo de verificación de estado más amplio.

Paso a paso

Paso 1. Asegúrate de que tu conexión con Zoho CRM está autenticada y de que tu token de acceso es válido. El flujo OAuth requiere una sesión conectada antes de poder acceder a cualquier endpoint de configuración — si la conexión falta o ha expirado, la API rechazará la solicitud. ^[3]

Paso 2. Confirma que tus scopes de OAuth incluyen los permisos necesarios a nivel de organización de CRM. El conjunto de scopes utilizado para Zoho CRM debe cubrir ZohoCRM.org.ALL (o como mínimo acceso de lectura a la configuración de la organización) para que los endpoints de configuración sean accesibles con tu token. ^[7]

Paso 3. Realiza una solicitud GET al endpoint /settings/sendmailconfig. Esta es la operación dedicada — denominada getsendmail_config — dentro de la categoría de configuración Mail & Social de la API de Zoho CRM. ^[5]

GET /settings/send_mail_config

En Python, usando el wrapper del cliente CRM, la llamada tiene este aspecto: ^[5]

def get_send_mail_config(self):
    return self.c.request("GET", "/settings/send_mail_config")

Paso 4. Analiza el objeto de respuesta devuelto por el endpoint. El resultado contendrá la configuración de correo saliente de tu organización. Almacena o registra estos datos según sea necesario para tu lógica de auditoría o integración. ^[5]

Paso 5. Si trabajas en un entorno con múltiples aplicaciones (CRM + Desk), asegúrate de apuntar específicamente al cliente de la API de CRM — no al cliente de Desk — ya que /settings/sendmailconfig es un endpoint con ámbito de CRM. El parámetro app_type en la capa de conexión controla qué cliente de API se instancia. ^[1]

---

> Nota: Beam Help es soporte experto independiente para Zoho — no somos el soporte oficial de Zoho. Para problemas de facturación o a nivel de cuenta, contacta directamente con Zoho.

---

Errores comunes

• Sin conexión activa. Si el registro zoho_connections del usuario actual falta o el token ha expirado, la capa de API mostrará un error como *«Zoho no está conectado para esta aplicación. Por favor, vuelve a conectar.»* Verifica siempre el estado de la conexión antes de llamar a los endpoints de configuración. ^[1]
• Centro de datos incorrecto. El token OAuth y el dominio de la API están vinculados al centro de datos (com, eu, in, etc.) registrado en el momento del intercambio del token. Enviar una solicitud al dominio regional incorrecto resultará en un fallo de autenticación. Comprueba el valor api_domain devuelto durante el intercambio del código OAuth. ^[3]
• Scopes insuficientes. Si ZohoCRM.org.ALL no se incluyó cuando se otorgó el consentimiento OAuth, el endpoint de configuración devolverá un error de permisos. Es posible que necesites revocar el token existente y volver a autorizar con la lista de scopes correcta. ^[7]

Qué verificar

• Validez del token: Confirma que el token de acceso no ha expirado y que hay un token de actualización válido disponible para obtener uno nuevo si es necesario. ^[3]
• Cobertura de scopes: Verifica que ZohoCRM.org.ALL está presente en los scopes otorgados durante la autorización OAuth. ^[7]
• Cliente de API correcto: Asegúrate de que la solicitud se enruta a través del cliente de la API de CRM (no de Desk) y de que app_type está configurado como "crm" en tu configuración de conexión. ^[1]