Pular para o conteúdo principal

❓ Frequently Asked Questions (FAQ)

Find quick answers to the most common questions about WhatsApp buttons in Stevo.

🔘 General Questions​

Do buttons work on all devices?​

✅ Yes, buttons are native to WhatsApp and work on:

  • Android (version 2.21.0 or higher)
  • iOS (version 2.21.0 or higher)
  • WhatsApp Web
  • WhatsApp Business

Do buttons work in groups?​

❌ No, currently interactive buttons work only in private chats (1-to-1). This is a WhatsApp limitation, not Stevo's.

Alternative for groups:

  • Send the message with buttons privately to each member
  • Use text messages with numbered options in groups

Can I use emojis in buttons?​

✅ Yes, you can use emojis in:

  • Titles
  • Descriptions
  • Button text
  • List options

Example:

#bt|🍕 Menu|Choose your favorite|Enjoy!|🍕 Pizza*pizza/🍔 Burger*burger/🌮 Taco*taco

How many times can a user click a button?​

Buttons are single-use per message. Once the user clicks:

  • The button becomes visually "disabled"
  • The user cannot change their choice
  • You would need to send a new message with buttons for another interaction

Can I edit a message with buttons after sending?​

❌ No, messages with buttons cannot be edited after sending. If you need to change something, you must:

  1. Delete the message (if still possible)
  2. Send a new corrected message

🔧 Troubleshooting​

Button doesn't appear / Message is sent as plain text​

Common causes:

  1. Syntax error in command

    ❌ Incorrect: #bt|Title|Desc|Footer|Option1*id1|Option2*id2
    ✅ Correct:   #bt|Title|Desc|Footer|Option1*id1/Option2*id2

    Note: Use / to separate options, not |

  2. Spaces or special characters

    • Don't use line breaks in the command
    • Avoid special characters like: < > { } [ ]

  3. API not configured correctly

    • Check if you're using the correct API
    • Confirm your access token

  4. Limits exceeded

    • Reply buttons: maximum 3 options
    • List buttons: maximum 10 options

User doesn't receive buttons​

Check:

  1. User's WhatsApp version

    • Must be 2.21.0 or higher
    • Ask them to update the app

  2. Chat type

    • Is it a group? Buttons don't work in groups
    • Is it a broadcast? Will only work if contact has you saved

  3. Compatible device

    • Some very old devices may have issues
    • Test on WhatsApp Web

Buttons appear but don't respond to clicks​

Possible causes:

  1. Temporary WhatsApp issue

    • Wait a few minutes
    • Restart WhatsApp
    • Check internet connection

  2. Device cache

    • Clear WhatsApp cache
    • Restart phone

  3. Webhook not configured

    • If using automation, check your webhook
    • Confirm your server is receiving responses

PIX button doesn't open bank app​

Solutions:

  1. Check PIX key

    • Is it active in your bank?
    • Is the format correct? (numbers only for phone/CPF)

  2. Banking app not installed

    • User needs a bank app with PIX
    • Offer alternatives (QR code, PIX code)

  3. iOS device

    • Some banks on iOS require additional configuration
    • Test with another payment method

Call button doesn't work​

Check:

  1. Number format

    ❌ Incorrect: +55 (27) 98112-0473
    ✅ Correct:   5527981120473
    • No spaces, parentheses or dashes
    • Include country code

  2. Phone permissions

    • User must have calling permissions enabled
    • Check if not in airplane mode

URL button doesn't redirect​

Common problems:

  1. URL without protocol

    ❌ Incorrect: www.google.com
    ✅ Correct:   https://www.google.com

  2. Invalid or offline URL

    • Check if the site is online
    • Test the URL in browser first

  3. Firewall or restrictions

    • Some countries/networks block certain sites
    • Check if the URL is accessible

📊 Best Practices​

Validation before sending​

Always validate your commands before sending to production.

Testing​

Before using in production:

  1. ✅ Test in a test chat
  2. ✅ Check on different devices
  3. ✅ Confirm webhook works
  4. ✅ Test all possible paths
  5. ✅ Check system responses

Error handling​

Always have a plan B:

Message with button: [Sent]

After 2 minutes without response:
"Had problems with the buttons?
You can reply with:
1 - Option A
2 - Option B
3 - Option C"

📞 Support​

Still having problems?​

  1. Review official documentation:

  2. Community:

    • Stevo users WhatsApp group
    • Telegram channel

  3. Direct support:

💡 Pro Tips​

Performance​

  • ⚡ Cache common commands (don't regenerate every time)
  • ⚡ Use templates for repetitive commands
  • ⚡ Pre-validate before sending to API

Monitoring​

  • 📊 Track which buttons get more clicks
  • 📊 Measure user response time
  • 📊 Identify buttons that cause confusion

UX​

  • 🎨 Keep style consistency
  • 🎨 Use emojis to improve readability
  • 🎨 Short and clear texts
  • 🎨 Always offer "exit" (cancel, back)

Found an error in the documentation or have a suggestion? Contact us! 💬