node-red-telegram-account/sample/auth.html

<script type="text/javascript">
  RED.nodes.registerType("auth", {
    category: "telegram-account",
    color: "#a6bbcf",
    defaults: {
      api_id: { value: "", required: true },
      api_hash: { value: "", required: true },
      phoneNumber: { value: "", required: true },
      password: { value: "" },
      sessionLocation: { value: "" },
    },
    inputs: 1,
    outputs: 1,
    icon: "font-awesome/fa-lock",
    label: function () {
      return this.name || "Telegram Auth";
    },
    oneditprepare: function () {
      // Initializing Values
      $("#node-input-api_id").val(this.api_id || "");
      $("#node-input-api_hash").val(this.api_hash || "");
      $("#node-input-phoneNumber").val(this.phoneNumber || "");
      $("#node-input-password").val(this.password || "");
      $("#node-input-sessionLocation").val(this.sessionLocation || "");
    },
    oneditsave: function () {
      // Saving values
      this.api_id = $("#node-input-api_id").val();
      this.api_hash = $("#node-input-api_hash").val();
      this.phoneNumber = $("#node-input-phoneNumber").val();
      this.password = $("#node-input-password").val();
      this.sessionLocation = $("#node-input-sessionLocation").val();
    },
  });
</script>

<script type="text/html" data-template-name="auth">
  <div class="form-row">
    <label for="node-input-api_id"> <i class="fa fa-key"></i> API ID </label>
    <input type="text" id="node-input-api_id" placeholder="Enter your API ID" />
  </div>

  <div class="form-row">
    <label for="node-input-api_hash">
      <i class="fa fa-lock"></i> API Hash
    </label>
    <input
      type="text"
      id="node-input-api_hash"
      placeholder="Enter your API Hash"
    />
  </div>

  <div class="form-row">
    <label for="node-input-phoneNumber">
      <i class="fa fa-phone"></i> Phone Number
    </label>
    <input
      type="text"
      id="node-input-phoneNumber"
      placeholder="Enter your phone number"
    />
  </div>

  <div class="form-row">
    <label for="node-input-password">
      <i class="fa fa-unlock-alt"></i> Password (optional)
    </label>
    <input
      type="password"
      id="node-input-password"
      placeholder="Enter your password (if any)"
    />
  </div>

  <div class="form-row">
    <label for="node-input-sessionLocation">
      <i class="fa fa-folder"></i> Session Location
    </label>
    <input
      type="text"
      id="node-input-sessionLocation"
      placeholder="Enter the session location"
    />
  </div>

  <p>
    <strong>Note:</strong> This configuration is required for connecting to the
    Telegram API and starting a session.
  </p>
</script>

<script type="text/html" data-help-name="auth">
  <p>
    The <b>auth</b> node facilitates Telegram API authentication using the
    <code>telegram</code> library. It allows users to authenticate a session and
    retrieve a stringSession for future use.
  </p>

  <h3>Inputs</h3>
  <dl class="message-properties">
    <dt>
      payload.api_id
      <span class="property-type">number | string</span>
    </dt>
    <dd>The Telegram API ID. Required for authentication.</dd>

    <dt>
      payload.api_hash
      <span class="property-type">string</span>
    </dt>
    <dd>The Telegram API hash. Required for authentication.</dd>

    <dt>
      payload.phoneNumber
      <span class="property-type">string</span>
    </dt>
    <dd>The phone number associated with the Telegram account.</dd>

    <dt>
      payload.password
      <span class="property-type">string</span>
    </dt>
    <dd>
      The password for two-factor authentication (if enabled on the Telegram
      account).
    </dd>

    <dt>
      payload.sessionLocation
      <span class="property-type">string</span>
    </dt>
    <dd>
      The location to store the session string. Uses stringSession by default.
    </dd>
  </dl>

  <h3>Outputs</h3>
  <dl class="message-properties">
    <dt>
      topic
      <span class="property-type">string</span>
    </dt>
    <dd>
      - <b>"auth_success"</b>: Authentication was successful. -
      <b>"auth_error"</b>: An error occurred during authentication.
    </dd>

    <dt>
      payload
      <span class="property-type">object</span>
    </dt>
    <dd>
      For <b>"auth_success"</b>:
      <ul>
        <li>
          <code>payload.stringSession</code>: The generated session string.
        </li>
        <li><code>payload.message</code>: Success message.</li>
      </ul>
      For <b>"auth_error"</b>:
      <ul>
        <li>
          <code>payload.error</code>: The error message describing the issue.
        </li>
      </ul>
    </dd>
  </dl>

  <h3>Details</h3>
  <p>
    To use the <b>auth</b> node, pass the required API credentials and phone
    number as part of the input message payload. The node will initiate the
    Telegram authentication flow. If a two-factor password is required, include
    it in the <code>payload.password</code>.
  </p>

  <p>
    The node temporarily stores the phone code resolver in the flow context
    under the key <code>phoneCode</code>. This allows subsequent nodes to
    resolve the phone code using a separate input mechanism, such as user
    interaction.
  </p>

  <h3>Example</h3>
  <pre>
    {
        "payload": {
            "api_id": 123456,
            "api_hash": "your_api_hash",
            "phoneNumber": "+123456789",
            "password": "your_password"
        }
    }
    </pre
  >
  <p>
    This example input payload initiates the authentication process. Upon
    receiving the phone code, it should be resolved using a dedicated node or
    interface.
  </p>
</script>