Conecta una cuenta de Telegram

Puedes conectar tu propia cuenta de Telegram a Wbiztool, junto a tus números de WhatsApp. Envía con la misma API y las mismas páginas que un número de WhatsApp, y la gente ve tus mensajes como mensajes normales de Telegram enviados por ti.

• Una sola API para ambos. Enviar mensaje, Enviar a varios números, Programar mensaje, Enviar a un grupo, Cancelar mensaje y los webhooks de estado de los mensajes funcionan igual. Pasa el ID de la cuenta de Telegram como whatsapp_client.
• Las mismas páginas. El Envío rápido, las campañas y los recordatorios pueden enviar desde ella.
• Más formas de llegar a la gente. Envía a un número de teléfono, a un @username, a un enlace t.me o a un grupo.

Quién puede hacerlo: los Propietarios y Editores conectan y gestionan las cuentas de Telegram.

Antes de empezar#

• Telegram en tu teléfono, con la sesión iniciada en la cuenta desde la que quieres enviar.
• Una dirección de correo confirmada.
• Un plan con los pagos al día y una plaza libre para un número. Una cuenta de Telegram ocupa una de las plazas de números de tu plan, como un número de WhatsApp. Consulta Límites de números.
• Mensajes disponibles en tu plan. Cada mensaje desde una cuenta de Telegram usa un crédito de mensajes, como en WhatsApp.

Conectar tu cuenta#

En la página Números, haz clic en Añadir cuenta de Telegram. También lo encuentras al pie de la ventana Añadir un número de WhatsApp: ¿Vas a conectar una cuenta de Telegram? Añadir cuenta de Telegram.

La ventana Añadir una cuenta de Telegram ofrece dos formas de iniciar sesión: Escanear código QR o Código de inicio de sesión. Las dos dan el mismo resultado.

Con un código QR#

Usa esta forma cuando tu teléfono está junto a la computadora.

1. Abre Añadir cuenta de Telegram

   En la página Números, haz clic en Añadir cuenta de Telegram. La ventana se abre con Escanear código QR seleccionado.

2. Muestra el código QR

   Haz clic en Mostrar código QR. La ventana Escanea con Telegram muestra el código.

3. Abre Añadir dispositivo en tu teléfono

   Abre Telegram en tu teléfono y ve a Ajustes → Dispositivos → Añadir dispositivo.

4. Escanea el código

   Apunta el teléfono al código QR. El código cambia cada 30 segundos: escanea el más reciente. Cuando el inicio de sesión funciona, la ventana muestra Cuenta de Telegram conectada y "… está conectado. Los mensajes que envíes desde esta cuenta salen por Telegram."

Con un código de inicio de sesión#

Usa esta forma cuando no puedes escanear un código QR, por ejemplo cuando el teléfono es tu único dispositivo.

1. Elige Código de inicio de sesión

   En la ventana Añadir una cuenta de Telegram, haz clic en la pestaña Código de inicio de sesión.

2. Escribe tu número

   Comprueba tu país en Código de país. En Número de teléfono de Telegram, escribe el número que usa tu cuenta de Telegram, sin el código de país, por ejemplo 9876543210. Haz clic en Enviar código de inicio de sesión.

3. Escribe el código

   Telegram envía un código de inicio de sesión a tu app de Telegram (o por SMS). En la ventana Introduce el código de inicio de sesión, escríbelo en Código de inicio de sesión y haz clic en Iniciar sesión. La ventana muestra entonces Cuenta de Telegram conectada.

Verificación en dos pasos#

Si tu cuenta tiene la verificación en dos pasos, la ventana pide su contraseña de Telegram después del código QR o del código de inicio de sesión: Introduce tu contraseña de Telegram. Escribe tu contraseña de Telegram (la de la nube) en Contraseña de Telegram y haz clic en Iniciar sesión. Wbiztool la usa una sola vez para iniciar sesión y nunca la guarda.

Después de conectar#

• La cuenta recibe una tarjeta en la página Números con una insignia Telegram y su ID, por ejemplo ID 702. Haz clic en el ID para copiarlo: úsalo como whatsapp_client en la API, igual que con un número.
• Haz clic en Enviar mensaje de prueba para comprobar que envía. En Enviar a, escribe un @username o un número de teléfono con su código de país, por ejemplo @name o +91 98765 43210.
• Renombrar y Eliminar funcionan igual que con un número de WhatsApp. Consulta Gestionar un número.

Enviar desde tu cuenta de Telegram#

Elige la cuenta de Telegram como cualquier número: en De en el Envío rápido, como número de envío de una campaña o de un recordatorio, o con su ID como whatsapp_client en la API. Sus mensajes aparecen en Reportes, y el webhook de Enviar mensaje informa SENT o FAILED igual que en WhatsApp.

curl -X POST https://wbiztool.com/api/v1/send_msg/ \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": 12345,
    "api_key": "YOUR_API_KEY",
    "whatsapp_client": 702,
    "phone": "@emma_thompson",
    "msg": "Hi Emma, your order #4821 has shipped and will arrive on Thursday."
  }'

Reemplaza 12345, YOUR_API_KEY y 702 por tus propios valores: 702 es el ID de la cuenta de Telegram que aparece en su tarjeta.

A quién puedes enviar#

Desde una cuenta de Telegram, phone en la API (y los números en el Envío rápido, los números de una campaña y el campo Enviar a de un recordatorio) acepta cualquiera de estos:

Los nombres de usuario, los enlaces t.me y tg:<id> solo funcionan desde una cuenta de Telegram. Desde un número de WhatsApp, Enviar mensaje y Programar mensaje responden "Telegram usernames can only be sent to from a Telegram account: pass its id as whatsapp_client", y Enviar a varios números los omite.

Qué cuenta elige la API#

Cuando omites whatsapp_client, Enviar mensaje usa el único número conectado, WhatsApp primero:

• Un único número de WhatsApp conectado se usa aunque también haya una cuenta de Telegram conectada. Añadir una cuenta de Telegram no pasa tus integraciones existentes a ella.
• Una cuenta de Telegram solo se usa cuando no hay ningún número de WhatsApp conectado.
• Un @username usa la única cuenta de Telegram conectada.

Para enviar desde la cuenta de Telegram en cualquier otro caso, pasa su ID como whatsapp_client.

Grupos#

Desde una cuenta de Telegram, group_name (y Grupos en el Envío rápido) acepta:

• el @username o el enlace t.me de un grupo público, por ejemplo @lumen_club o t.me/lumen_club, o
• el nombre exacto de un grupo o canal en el que está la cuenta, por ejemplo Lumen VIP Club. Las mayúsculas y minúsculas no importan.

La cuenta ya debe ser miembro del grupo y tener permiso para publicar en él. Nunca se une a un grupo por sí sola.

• Si ningún grupo coincide, el mensaje falla con "Group not found".
• Si la cuenta no puede publicar allí, falla con "This Telegram account can't post in that group: join it in Telegram first (or the group lets only admins post)".

Límites de Telegram#

Telegram limita a cuántas personas que no le han escrito puede enviar mensajes una cuenta. Las cuentas nuevas son las más limitadas.

• Cuando Telegram pide ir más despacio, la cuenta hace una pausa y sus mensajes esperan. Salen después de la pausa.
• Cuando Telegram limita los mensajes a desconocidos, ese mensaje falla con "Telegram limited this account: it can't message people who haven't contacted it for now. Sending resumes in an hour", y la cuenta descansa una hora.

La bandeja (Unibox)#

Una cuenta de Telegram se puede añadir a la bandeja Unibox como un número: en Números de la bandeja, haz clic en Añadir número a la bandeja y elígela. Ocupa uno de los números de bandeja de tu complemento Unibox, como un número de WhatsApp.

• Sus chats privados aparecen en la bandeja: los mensajes que recibe y los que se envían desde el teléfono o desde Wbiztool. Los chats de Telegram llevan una marca de Telegram.
• Los archivos de hasta 16 MB se copian en la bandeja.
• Las respuestas funcionan incluso con personas que ocultan su número.
• Los grupos, los canales, Mensajes guardados y el chat de servicio del propio Telegram (el de los códigos de inicio de sesión) nunca se muestran.

El webhook de una cuenta de la bandeja publica sus mensajes igual que el de un número. El contenido tiene platform con valor telegram, y contact.phone y message.from son el número de la persona, su @username o tg:<id>: envía tu respuesta a ese valor como phone. Consulta Contenido.

Desconectar o reconectar#

• Desconectar en la tarjeta impide que la cuenta envíe. También cierra la sesión de Wbiztool en la lista de dispositivos de la cuenta en Telegram.
• Si Telegram cierra la sesión, por ejemplo cuando cierras la sesión de Wbiztool en Ajustes → Dispositivos, o la cuenta cierra sesión en todas partes, la tarjeta muestra No conectado. Los Propietarios y Editores reciben una alerta de desconexión redactada para Telegram, igual que con un número de WhatsApp. Consulta Alertas de desconexión de WhatsApp.
• Mientras la cuenta no está conectada, sus mensajes esperan en Pendientes de envío.
• Para volver a conectarla, haz clic en Reconectar en su tarjeta e inicia sesión otra vez, con un código QR o un código de inicio de sesión.

Aún no disponible#

• Exportar los miembros de los grupos de Telegram. La exportación de miembros de grupos solo funciona con grupos de WhatsApp.
• Los grupos de Telegram en la bandeja Unibox. Allí solo aparecen los chats privados.

Solución de problemas#

Relacionado#

• Conecta tu número de WhatsApp
• Enviar un mensaje rápido
• Bandeja de entrada Unibox y Webhooks de mensajes entrantes
• Planes y facturación
• API: Enviar mensaje, Enviar a un grupo y Listar números conectados