Webhook ideas/feedback

[feral sluice]

[muted ivy]

Hey

[plucky peak]

Good idea.

[lofty stream]

make it send to discord if the url is a discord webhook url

[muted ivy]

For the retry thing I'm in

[feral sluice]

we could add formatting modes perhaps yeah

[muted ivy]

But what event would you add ?

There's not a lot of event that top.gg need to send rn

[feral sluice]

im thinking of mostly reviews right now so you can get your reviews through a realtime event

[lofty stream]

self promo

[spare nova]

erm

[muted ivy]

I WOULD LOVE THAT

[hazy oriole]

Solve for retries

[zealous prawn]

what about adding webhooks for auctions?

[lofty stream]

wouldn't that incentivise reviews though which goes against TOS

[muted ivy]

Rn I have an internal way of submitting feedbacks/ratings

[feral sluice]

we're rewriting auctions from scratch atm. so there wont be further integration there :(

[zealous prawn]

understood.

it is of interest so hopefully in the future

[sudden pier]

in my voting confirmation DM, i add a prompt to leave a review on top.gg. having a field that tells me if the user has left a review (doesn't need to tell me their rating) it would be nice to know so i can stop bothering them with the prompt or if we get webhooks for new reviews i can store that and deal with it on my end

[solid roost]

Reviews would be awesome!

[feral sluice]

webhooks with new reviews would allow you to do that yeah

[molten patrol]

Reminder webhook events, add an opt in system via top.gg so reminders are only sent if they opt in.

[feral sluice]

not sure if we want to do a lot of processing on webhook payloads since we send out an insane amount of them 😂

[upbeat breach]

I'd honestly love to see more events added, especially for reviews. Would it then be possible to reward users for leaving reviews too? That'd open up some cool use cases

[zealous prawn]

i think thats against ToS?

although could be wrong

[feral sluice]

yeah think that's not allowed

[upbeat breach]

Aight wanted to make sure

[velvet spindle]

https://media.discordapp.net/attachments/939147074702811148/1080936807887278140/FEFBBE24-B078-43F3-943D-403FC97327C4.gif

[molten patrol]

Its not

[feral sluice]

i dont know our rules

[molten patrol]

Thats what you have me for!

[feral sluice]

it sounds like something we've discussed at some point tho

curious if that should not be allowed tho

[upbeat breach]

Are there any other events planned/being discussed if I may ask?

[molten patrol]

Oh i meant its not allowed

[feral sluice]

oh

ok i do know the rules!

unbonk me right now @civic night

[spiral holly]

Reviews

[civic night]

[velvet spindle]

https://tenor.com/view/bonk-cat-slap-cat-gif-22044106

[feral sluice]

only reviews is beign considered right now

[granite jungle]

that'll be great

[sudden pier]

reports... so every time someone reports my bot i can ban them

[mossy sun]

are we also gonna have webhooks for servers

[upbeat breach]

What kind of data would actually be included in the review event? Like would it have the username, star rating, and the review text itself?

[velvet spindle]

~~auto ban ~~

[feral sluice]

[feral sluice]

yes

[mossy sun]

o i canot read

[feral sluice]

definitely a more up-to-date user and listing data. other than that im not sure yet

[molten patrol]

True logs would be nice, but it might be necessary to include searching/filters.

IE Large bots with users claiming they didnt get rewards. Allowing the admins to search for them specifically could be useful.

[upbeat breach]

Also quick question: are reviews automoderated, or only checked manually? Just wondering because if I were to display them publicly somewhere, I'd want to make sure no bad bad stuff slips through

[feral sluice]

we manually check them, but we do have a auto-moderator now. we should probably run some sort of analysis on a newly created one

[upbeat breach]

Aight thanks

[feral sluice]

yeah logs are gonna be awesome. but heavy for whichever db I decide to use for it

[spiral holly]

Limits it to 1 month ?

[feral sluice]

i mean it should be fine either way

[gaunt violet]

I have concerns for review webhooks, it may encourage people to give rewards for leaving reviews which afaik is against your rules

[upbeat breach]

yeah that's what I asked minutes ago, it is not allowed

you'd have to actually control bots for that then.. or just get reports about that

[gaunt violet]

Right

[sudden pier]

i know this is more API related and not webhooks exactly, but when checking the endpoint to see if a user has voted, it would be nice to have the timestamp of when they last voted and the rest of the properties you get on the webhook
https://docs.top.gg/docs/API/bot#individual-user-vote

just so i can send them a reminder at the right time if for some reason the webhook didn't work

[upbeat breach]

i do that manually tbh

I just track current timestamp when its received

[molten patrol]

He means when you use the api not webhooks

[upbeat breach]

i might be dum dum

[surreal orbit]

Um idk

[viscid bone]

Not bad but I feel like having a webhook for a review encourages review rewards which are against your ToS

It may be fun to know if my bot was added to a server through top.gg for analytics tho so maybe a webhook when someone clicks invite?

[sudden pier]

you can already track that using a state parameter on your invite link on top.gg

[viscid bone]

Ah

[sudden pier]

definitely not easy, but technically possible

would be nice to have a webhook like that for beginners

[feral sluice]

i would love to first update the api before i add stuff to it

[sudden pier]

yeah no biggie

[feral sluice]

current one adds unnecessary load on the web server

[sudden pier]

tbh i havent used the api in AGES because the website has been so stable since you took over

[feral sluice]

almost 99.99% uptime

[safe nymph]

Sounds cool

[sonic nova]

piggybacking off the API comments - i wish that the API would have an event that automatically gets sent to your app when someone votes (e.g. VoteForBotEvent); i currently have a workaround where i use the webhook that sends the user id into a channel, then read that message using my bot but it's really janky and i would like a more official solution

[sudden pier]

You can just send the webhook directly to your bot. That's what it's for
https://docs.top.gg/docs/Resources/webhooks

You can ask people for help in #topgg-api

[digital ivy]

Listen to webhooks, one endpoint for each botlist, and storing them in a database for analytics & votewalling some features

[viscid bone]

Bot events are controlled by Discord - you need your own setup to receive a request from topgg, no dAPI wrapper will do it out of the box for you

[sudden pier]

Top.gg's SDK does it and you can use that in your bot's codebase

[gaunt violet]

been doing this for a long time haha, surprised more people don't think of it tbh

[sudden pier]

is top.gg also your top source of traffic then? for me it's discord, then top.gg, then my website. every other bot list is like 2 invites per day for the top one

[gaunt violet]

yeah those top 3 match for me too lol, top.gg, then half of that is discord, and another half of that is website

[sudden pier]

yeah it used to be the same for me but at a certain point discord became #1, not because of the app directory (im not on it) but just the invite button on the bot profile. as you join more servers, that entry point becomes naturally available in more places and so it just naturally takes over as top source

but in terms of bot lists it's by far just top.gg and nothing else LOL

[gaunt violet]

that makes a lot of sense yeah

it could be different if i looked at a more narrow window of time

but also varies based on how auctions are doing

top.gg is still definitely highest for me though

[sudden pier]

same yeah if i have ads running on top.gg it basically 2x the joins from top.gg and surpasses discord

[wraith osprey]

hey, any update on the localization of the bot descriptions?

[fair wren]

How about letting bot developers publish webhooks for their own bots? So that bots have an easier time integrating with each other

[viscid bone]

Wdym

You can already do that it‘s on you to implement

[feral sluice]

Yeah I do it on my bot

[safe nymph]

You use express to handle requests from top.gg

[molten patrol]

My Wishlist for the webhooks update
While most developers using webhooks will never have a need for these features they will be important for vote tracking services.
With the addition of roblox certain new data will be very nice in the webhook.

{
  id: "12345", // unique vote ID, can be useful for debugging
  type: "upvote",
  isWeekend: true,
  query: "",
  project: {
    provider: "Discord", // Really needs to be specified for vote tracking services
    topggID: "12345", // unlikely to be useful, but good to include
    id: "7891011", // Provider ID
    name: "luca", // Keeping these up to date on Top.gg isnt always 100% but its way better than having no access at all(discord servers)
    avatar: "https://example.com/avatar", // Same as above
    points: 1500,
    monthlyPoints: 250
  },
  user: {
    provider: "Discord", // Really should be specified, especially if roblox logins are added
    topggID: "12345", // May be required for tracking vote rewards if sometimes the provider is discord and sometimes roblox
    id: "7891011", // Provider ID
    username: "Veld", // Roblox can be a pain to pull this data from(username and avatar are seperate endpoints)
    avatar: "https://example.com/avatar", // Roblox can be a pain to pull this data from(username and avatar are seperate endpoints)
    points: 10,
    monthlyPoints: 4,
    streakPoints: 3
  },
}