Para qué sirve#
El canal de YouTube trae a Connecto los comentarios de los videos de tu canal y te deja responderlos desde el Chat. Cada persona que comenta se convierte en un contacto y sus comentarios forman una conversación, igual que en los demás canales.
Quién puede usarlo: administradores (para conectarlo). Cualquier asesor atiende las conversaciones.
Cómo llegar: Ajustes de sistema → Canales de mensajería → Agregar canal → YouTube.
• No entrega mensajes privados por API: solo comentarios.
• No avisa cuando llega un comentario. Por eso Connecto los lee cada N minutos (tú eliges cada cuántos).
• El chat en vivo de las transmisiones es opcional y gasta mucha más cuota: se activa aparte, con aviso y confirmación.
• Lo que respondes es una respuesta pública bajo el comentario. No se pueden enviar archivos, ni reacciones, ni plantillas.
• Solo se importan los comentarios publicados desde que conectas el canal.
Lo que necesitas antes (una sola vez)#
Connecto se conecta a YouTube con el inicio de sesión de Google. Hay dos formas:
- Con tu propio proyecto de Google Cloud (lo habitual). Lo preparas una vez y tú controlas los permisos y la cuota.
- Con las credenciales de la plataforma, si quien administra el servidor las configuró (variables
YOUTUBE_CLIENT_IDyYOUTUBE_CLIENT_SECRET). En ese caso la ventana no pide nada y solo inicias sesión en Google.
Preparar tu proyecto en Google Cloud#
- En console.cloud.google.com crea un proyecto.
- APIs y servicios › Biblioteca: activa YouTube Data API v3.
- Pantalla de consentimiento de OAuth: tipo Externo, agrega el permiso
https://www.googleapis.com/auth/youtube.force-ssly pulsa Publicar aplicación.
Si la dejas en «Pruebas», Google vence el permiso a los 7 días y Connecto dejará de leer comentarios. - Credenciales › Crear credenciales › ID de cliente de OAuth, tipo Aplicación web. En URI de redireccionamiento autorizados pega exactamente la dirección que muestra la ventana de Connecto (termina en
/api/youtube_oauth.php). - Copia el ID de cliente y el secreto de cliente.
Conectar el canal#
- Pulsa Agregar canal › YouTube.
- Pega el ID de cliente y el secreto (el secreto se guarda cifrado). El nombre es opcional.
- Pulsa Continuar con Google, inicia sesión y elige la cuenta (o la cuenta de marca) dueña del canal.
- Google dirá «aplicación no verificada»: es normal en tu propio proyecto. Pulsa Avanzado › Ir a … y acepta el permiso; no lo desmarques.
- Vuelves a Connecto con el mensaje «Canal de YouTube conectado». La tarjeta aparece en Canales, con el botón Detalle de canal.
Detalle de canal › pestaña YouTube#
| Qué | Para qué |
|---|---|
| Cuenta conectada | El canal autorizado y el botón Volver a autorizar (si Google revocó el permiso o quieres cambiar de cuenta). |
| Leer los comentarios | Cada cuánto lee Connecto: cada 1, 2, 3, 5 (por defecto), 10, 15, 30 minutos, cada hora o más, hasta una vez al día. Se guarda al cambiarlo. |
| Leer ahora | Lectura inmediata, sin esperar el intervalo. |
| Cuota de YouTube | Cuántas unidades diarias te dio Google y cómo repartirlas (ver abajo). |
| Chat en vivo | Interruptor opcional, con aviso y confirmación (ver abajo). |
| Estado | Última lectura, resultado (o el error), mensajes recibidos y los hilos que se siguen. |
Afinar la cuota#
Google da a cada proyecto de Google Cloud una cantidad de unidades de cuota al día (10.000 por defecto) y se reinicia a medianoche, hora del Pacífico. Todo lo que Connecto hace con YouTube las gasta:
| Acción | Unidades |
|---|---|
| Leer comentarios (una consulta de hasta 100) | 1 |
| Responder a un comentario | 52 |
| Leer el chat en vivo (una consulta) | 5 |
| Escribir en el chat en vivo | 20 |
En Cuota de YouTube anotas tres números (se guardan solos):
- Cuota diaria total del proyecto: la que te concedió Google. Si pediste una ampliación, escribe aquí la nueva cifra. Va de 1.000 a 100.000.000.
- Tope para leer comentarios: cuando la lectura llega a este número, se detiene hasta el día siguiente. Por defecto, 8.000.
- Tope para el chat en vivo: lo mismo para el chat. Por defecto, 0 (el chat está apagado); al activarlo por primera vez se aparta una parte.
Lo que sobra de la cuota total es la reserva para responder: la pantalla la calcula y muestra cuántas respuestas caben al día. Lectura y chat deben dejar al menos 520 unidades (10 respuestas) del total. La pantalla también estima cuánto gasta el intervalo que elegiste y avisa si pasa de tu tope, y muestra barras con lo gastado hoy por cada concepto.
Si Google informa que se agotó la cuota del proyecto, todo se pausa hasta medianoche (hora del Pacífico). Si una respuesta ya no cabe en la cuota total, no se publica y el mensaje queda marcado como fallido con el motivo.
Chat en vivo (opcional)#
Además de los comentarios, Connecto puede leer el chat de las transmisiones en vivo de tu canal y dejarte responder. Está apagado por defecto y activarlo exige leer y aceptar un aviso, que también queda siempre visible en la pantalla:
- Gasta cuota. Cada consulta cuesta 5 unidades: con una consulta cada 30 segundos, una hora de transmisión gasta unas 600.
- La cuota se comparte con los comentarios y las respuestas; si Google agota la del proyecto, todo se pausa.
- Cada espectador que escribe crea un contacto y una conversación. Por eso hay un máximo de mensajes por transmisión (500 por defecto): al alcanzarlo, los demás no se importan y se cuenta cuántos se omitieron.
- Tus respuestas son públicas y las ve todo el chat. Máximo 200 caracteres y 20 unidades por mensaje.
- No es instantáneo. Connecto detecta que empezó una transmisión en la lectura de comentarios (cada N minutos) y solo lee el chat mientras está en vivo. Se importan solo los mensajes escritos después de conectar el canal.
Para activarlo, mueve el interruptor, marca «Entiendo el aviso» y pulsa Activar chat en vivo (el botón se habilita al marcar la casilla). Queda registrado quién lo aceptó y cuándo. Apagarlo no pide confirmación.
Con el chat activo puedes ajustar:
- Cada cuánto se lee el chat: cada 10, 15, 30 segundos, 1, 2, 5 o 10 minutos. Nunca más seguido de lo que YouTube pide en cada respuesta.
- Máximo de mensajes que se importan por transmisión: de 10 a 100.000.
Debajo ves las transmisiones detectadas (EN VIVO o terminadas), cuántos mensajes se importaron y omitieron y cualquier aviso. Los mensajes del chat llevan la insignia «En vivo · título». Si lo último que escribió el espectador fue en el chat, tu respuesta va al chat; si respondes a un comentario concreto con Responder, va a ese hilo de comentarios.
Cómo se ven los comentarios#
- Cada persona es un contacto (se identifica por su canal de YouTube) y tiene una conversación con todos sus comentarios, aunque sean de videos distintos.
- Cada mensaje muestra de qué video es (título y enlace) y distingue un comentario de una respuesta dentro de un hilo.
- Connecto sigue los hilos recientes durante 14 días para detectar respuestas nuevas de los espectadores; cuando alguien responde en un hilo, el mensaje cae en su conversación.
- Los comentarios del propio canal (por ejemplo, tus respuestas desde YouTube Studio) no se importan como mensajes de clientes.
Responder#
- Escribe como en cualquier conversación. La respuesta se publica como respuesta pública al hilo del último comentario de esa persona.
- Para contestar en otro video, usa Responder sobre el mensaje concreto: se publica en el hilo de ese mensaje.
- Solo texto, hasta 10.000 caracteres. Si YouTube no lo permite (comentario privado, borrado o comentarios desactivados), el mensaje queda marcado como fallido con el motivo.
- Los mensajes automáticos (bienvenida, cierre, encuestas, avisos de inactividad) no se publican en YouTube, para no llenar los comentarios de respuestas automáticas.
Si algo falla#
| Mensaje | Qué hacer |
|---|---|
| «Google ya no acepta el permiso… Vuelve a autorizarlo» | El permiso se revocó o venció (por ejemplo, la aplicación está en «Pruebas»). Pulsa Volver a autorizar. |
| «Google agotó la cuota diaria de este proyecto» | Se reanuda a medianoche (hora del Pacífico). Elige un intervalo más largo, reparte mejor la cuota o pide a Google más y anótala en Cuota de YouTube. |
| «Se alcanzó el tope diario de lectura…» o «…del chat en vivo» | Es el tope que tú pusiste. Súbelo en Cuota de YouTube o espera a medianoche (hora del Pacífico). |
| «La API YouTube Data API v3 no está activada» | Actívala en tu proyecto de Google Cloud (paso 2). |
| «La cuenta no tiene un canal de YouTube» | Al iniciar sesión, elige la cuenta (o cuenta de marca) que es dueña del canal. |
<!-- Fuente: node/src/youtube.js, shared/src/Core/YouTube.php, tenant-app/public/api/youtube_oauth.php, api/youtube_canal.php, configuracion/youtube_conectar.php, canal_detalle.php (pestaña YouTube), db/migrations/0165_youtube_canal.sql. Documentación de la API: developers.google.com/youtube/v3 -->