✅ Integration Test Reports — Help us verify adapters you have access to

[RecurPixel]

Why this discussion exists

RecurPixel.Notify ships with unit tests for every adapter, but integration testing requires
real API keys for every provider — and it is not possible for the core team to hold active
accounts and paid credentials for every platform.

This is where the community comes in.

If you have access to a provider — Twilio, FCM, AWS SNS, Vonage, or anything else —
you can run the integration test for that specific adapter in under 5 minutes and post
your results here. Verified reports get marked as ✅ Community Verified in the official
adapter docs and README.

---

Current Verification Status

Package	Provider	Channel	Unit Tested	Integration Tested	Community Approved
Email.SendGrid	Twilio SendGrid	Email	✅	✅	🔲
Email.Smtp	Any SMTP server	Email	✅	✅	🔲
Email.Mailgun	Mailgun	Email	✅	🔲	🔲
Email.Resend	Resend	Email	✅	🔲	🔲
Email.Postmark	Postmark	Email	✅	🔲	🔲
Email.AwsSes	AWS SES	Email	✅	🔲	🔲
Email.AzureCommEmail	Azure Communication Services	Email	✅	🔲	🔲
Sms.Twilio	Twilio	SMS	✅	✅	🔲
Sms.Vonage	Vonage (Nexmo)	SMS	✅	🔲	🔲
Sms.Plivo	Plivo	SMS	✅	🔲	🔲
Sms.Sinch	Sinch	SMS	✅	🔲	🔲
Sms.MessageBird	MessageBird	SMS	✅	🔲	🔲
Sms.AwsSns	AWS SNS	SMS	✅	🔲	🔲
Sms.AzureCommSms	Azure Communication Services	SMS	✅	🔲	🔲
Push.Fcm	Firebase Cloud Messaging	Push	✅	🔲	🔲
Push.Apns	Apple Push Notification Service	Push	✅	🔲	🔲
Push.OneSignal	OneSignal	Push	✅	🔲	🔲
Push.Expo	Expo Push	Push	✅	🔲	🔲
WhatsApp.Twilio	Twilio WhatsApp	WhatsApp	✅	✅	🔲
WhatsApp.MetaCloud	Meta Cloud API	WhatsApp	✅	🔲	🔲
WhatsApp.Vonage	Vonage WhatsApp	WhatsApp	✅	🔲	🔲
Slack	Slack Webhooks / Bot API	Team Chat	✅	✅	🔲
Discord	Discord Webhooks	Team Chat	✅	✅	🔲
Teams	Microsoft Teams Webhooks	Team Chat	✅	🔲	🔲
Mattermost	Mattermost Webhooks	Team Chat	✅	🔲	🔲
RocketChat	Rocket.Chat Webhooks	Team Chat	✅	🔲	🔲
Facebook	Meta Messenger API	Social	✅	🔲	🔲
Telegram	Telegram Bot API	Social	✅	✅	🔲
Line	LINE Messaging API	Social	✅	🔲	🔲
Viber	Viber Business Messages	Social	✅	🔲	🔲
InApp	Hook-based (user-defined storage)	In-App	✅	✅	🔲

Legend: ✅ Complete · 🔲 Not yet · ⚠️ Partial

This table is updated as reports are verified and approved.

---

How to Run the Integration Tests

All integration tests live in a single project — one test class per adapter, all sharing
the same configuration file.

Step 1 — Clone the repo and navigate to the integration test project

git clone https://github.com/recurpixel/notify.git
cd notify/tests/RecurPixel.Notify.IntegrationTests

Step 2 — Fill in your credentials

Copy the template and fill in only the providers you have access to. Every field you leave
blank is automatically skipped — that adapter's test will be marked as skipped, not failed.

cp appsettings.integration.json.example appsettings.integration.json

Then open appsettings.integration.json and fill in your credentials:

{
  "_readme": "Fill in the credentials for providers you want to test. Leave any field blank to skip that adapter automatically. NEVER commit this file — it is git-ignored.",
  "Integration": {
    "ToEmail":       "your-test-inbox@example.com",
    "ToPhone":       "+1234567890",
    "ToDeviceToken": "",
    "ToWhatsApp":    "",
    "ToSlack":       "",
    "ToTelegram":    ""
  },
  "Notify": {
    "Sms": {
      "Twilio": {
        "AccountSid": "ACxxx",
        "AuthToken":  "xxx",
        "FromNumber": "+0987654321"
      }
    }
  }
}

You only need to fill in the sections relevant to what you are testing. Everything else
can stay blank or be omitted entirely.

⚠️ appsettings.integration.json is git-ignored. It will never be committed.
Never paste real credentials anywhere else — not in issues, not in this thread.

Step 3 — Run only the adapter you want to test

Each adapter has its own test class. Run it by fully qualified name so you only execute
what you have credentials for:

# SMS — AWS SNS
dotnet test --filter "FullyQualifiedName~AwsSnsSmsIntegrationTests"

# SMS — Twilio
dotnet test --filter "FullyQualifiedName~TwilioSmsIntegrationTests"

# Email — SendGrid
dotnet test --filter "FullyQualifiedName~SendGridEmailIntegrationTests"

# Push — FCM
dotnet test --filter "FullyQualifiedName~FcmPushIntegrationTests"

# WhatsApp — Meta Cloud
dotnet test --filter "FullyQualifiedName~MetaCloudWhatsAppIntegrationTests"

Or run everything you have configured in one go — any adapter with blank credentials
is skipped automatically:

dotnet test

---

How to Submit a Report

Post a reply in this thread using the following template:

### Adapter: [e.g. RecurPixel.Notify.Sms.Twilio]
**Provider:** Twilio
**Channel:** SMS
**Package version:** x.x.x
**Date tested:** YYYY-MM-DD
**Test environment:** .NET 8 / local / CI / etc.

**Results:**
- [ ] SendAsync — single send passed
- [ ] SendBulkAsync — bulk send passed
- [ ] Fallback triggered correctly on simulated failure
- [ ] NotifyResult fields populated correctly (ProviderId, SentAt, Recipient, etc.)
- [ ] Delivery hook called with correct result
- [ ] Skipped tests correctly skipped when credentials are blank

**Screenshot:** [attach test run output — redact any sensitive values]
**Notes:** anything unusual, provider-specific behaviour, sandbox vs production differences

Once reviewed by the core team your adapter gets marked ✅ Community Verified and
your GitHub profile is credited in the verification entry.

---

Ground Rules

• Never post real API keys, tokens, or credentials — not even partially masked
• Use a sandbox or test account where the provider offers one
• One reply per adapter — if you test multiple adapters, post one reply each
• If you find a bug during testing open a separate issue rather than reporting it here
• Screenshots must redact any personal or sensitive values visible in output

---

Why This Matters

Every ✅ on that table is a signal to the next developer evaluating this library that the
adapter works in production, not just in mocked unit tests. The more providers the community
verifies, the more trustworthy the library becomes for everyone.

If an adapter has been sitting at ⏳ for a long time and you have access to that provider —
please test it. It takes less than 10 minutes and it helps every future user of that provider.

Drop your report below 👇