Skip to main content

Common Issues & Troubleshooting

Find solutions to common hurdles when setting up and scaling your AI agency infrastructure.

1. Domain Verification

Issue: "Domain status remains 'pending' after 24 hours."

  • Check DNS Propagation: DNS changes can take up to 48 hours, though they usually happen within 10-20 minutes. Use a tool like dig or an online DNS checker to verify your TXT and CNAME records are visible.
  • Verify Token: Ensure the TXT record name exactly matches _texterz-verify.your-domain.com and the value matches your Organization Token.
  • Trailing Dots: Some DNS providers automatically add a trailing dot to CNAME values. Ensure you didn't add an extra one yourself.

2. Bot Responses

Issue: "The bot is hallucinating or giving wrong information."

  • Check Similarity Threshold: Your "Similarity Threshold" might be too low (e.g., 0.3). Try increasing it to 0.7 or 0.8 to force the bot to be more accurate.
  • Knowledge Quality: Ensure your PDF or website data is clean. If a PDF has a lot of complex tables or images, the text extraction might be messy. Try converting complex data to simple markdown or text files.
  • System Prompt: Ensure your System Prompt explicitly tells the bot not to guess if it doesn't find the answer in the knowledge base.

3. WhatsApp Connection

Issue: "WhatsApp messages are not being sent."

  • Meta Business Status: Check your Meta Business Manager to ensure your phone number is "Connected" and has no active warnings.
  • Template Approval: Ensure the message template you are trying to use has been "Approved" by Meta. Pending or Rejected templates cannot be sent.
  • Credit Balance: Sending outbound messages via the WhatsApp API consumes platform credits. Ensure your organization has a sufficient balance.

4. API & Webhooks

Issue: "Webhook is not reaching my server."

  • HTTPS: Your endpoint must support HTTPS.
  • Payload Size: Ensure your server can handle the JSON payload size.
  • Webhook Logs: Visit the Webhook Logs in your bot settings to see the delivery status and response codes for every event sent to your server.

Still need help?

If you can't find the solution here, please email us at support@texterz.ai.