Skip to main content
Veriqa
Documentation Live demo

Other channels

Channels outside the Veriqa image: the adapters of the repository and a channel of your own over HTTP.

Every channel issues the base claims: channel_type channel_user_id name

A channel card lists what the channel adds on top of them.

— the phone number: it comes only when the application asks for it, and each channel returns it in its own way. More about the phone number

Adapters in the repository

Adapters outside the core, each connected in one of two ways: as a .NET assembly compiled into the host that embeds Veriqa, or as an HTTP service plugged in by configuration, with no compilation.

VK

Claims on top of the base
  • given_name
  • family_name
  • preferred_username
  • picture
  • locale
Confirmation in the channel
Yes
Secret message
No
Connected as
.NET assembly or HTTP service

If the link does not bring the sign-in code to the bot, the screen shows a code the user sends in the chat.

The bot of a VK community: its messages show on vk.com, in the VK app and in VK Messenger alike.

WhatsApp through Baileys in Node

Claims on top of the base
Confirmation in the channel
Yes — a poll with two options
Secret message
Yes
Connected as
HTTP service

Links a number as a companion device, like WhatsApp Web — no Meta Business account and no provider. For debugging and small teams: the client is unofficial, and WhatsApp may ban the number.

Slack

Claims on top of the base None — only the base ones
Confirmation in the channel
Yes
Secret message
Yes — typed by hand
Connected as
.NET assembly

The platform's links cannot pre-fill a message, so the user types the code shown on screen.

Discord

Claims on top of the base
  • preferred_username
  • picture
  • locale
Confirmation in the channel
Yes
Secret message
Yes — typed by hand
Connected as
.NET assembly

The platform's links cannot pre-fill a message, so the user types the code shown on screen.

Zalo

Claims on top of the base None — only the base ones
Confirmation in the channel
Yes
Secret message
Yes — typed by hand
Connected as
.NET assembly

The platform's links cannot pre-fill a message, so the user types the code shown on screen.

KakaoTalk

Claims on top of the base
  • locale
Confirmation in the channel
Yes — two quick-reply buttons
Secret message
Yes — typed by hand
Connected as
.NET assembly

The platform's links cannot pre-fill a message, so the user types the code shown on screen.

Threema

Claims on top of the base
  • preferred_username
Confirmation in the channel
Yes — the user replies YES or NO
Secret message
Yes
Connected as
.NET assembly

Needs a Threema Gateway ID with end-to-end encryption.

HTTP channel

Available

A channel Veriqa does not ship, connected as an external service written in any language: Veriqa talks to it over HTTP, the platform's keys stay with your service, and nothing has to be compiled — the service is plugged in by configuration. The main uses: a corporate messenger or a bot of your own, a regional platform, and a bot you already run, brought into the Veriqa flow without publishing a new one.

How to write an adapter

Terms

A channel card says whether a secret message is needed, whether there is confirmation in the channel and how the phone number comes. Here is what that means.

Secret message

The message with the sign-in code that the user sends to the channel themselves after tapping the link or scanning the QR code. Veriqa fills it in, the messaging app shows it ready, and the user only taps Send. Not every channel needs one.

Telegram, MAX
Not needed — the messaging app opens the bot and hands it the code by itself.
WhatsApp
Needed, for stronger security — the ready message goes out with one tap.
Email
The same with a pre-filled message — the one-tap email.
Video example Which email mode to choose

Confirmation in the channel

The bot asks right in the chat whether to let the sign-in through — into which app and from which device — with Confirm and Decline buttons. It can be switched to automatic mode, and then the sign-in goes through without an extra request.

MAX, Telegram
The question comes as soon as the user opens the link.
WhatsApp
The question comes in reply to the secret message.
Email
No question in the channel — optionally it is asked on a page in the browser.
Video example More in the documentation

Phone number

Veriqa takes the number only from the channel — the messaging app hands it over, the user never types it. It comes when the application asks for the phone scope, and each channel returns it in its own way; phone_number_verified says whether the channel proves the number is the user's.

WhatsApp
The simplest: the number comes with every message, nothing is asked.
Telegram, MAX
The bot asks after the sign-in is confirmed: the user shares their own contact with one button. MAX — in webhook mode only.
Other channels
A button or the profile without proof of ownership, only your own integration with the platform, or no number at all.
How each channel returns the number

Secret message — examples

WhatsApp: the secret message filled in by Veriqa, ready to send
WhatsApp
Email: the sign-in message filled in by Veriqa, ready to send
Email

Confirmation in the channel — examples

Telegram: the bot asks to confirm the sign-in, with Confirm and Decline buttons
Telegram
WhatsApp: the user has sent the secret message, and the bot asks to confirm the sign-in
WhatsApp