Firebase Integration

Overview

The Firebase integration uses FCM HTTP v1 with an Admin SDK service account. A single agent can manage notifications for multiple Firebase projects.

Skills that use this integration:

• int-firebase-push — Send push notifications by topic, device token, or condition

Agents that typically enable this integration:

• Push Notification Manager

Availability

Prerequisites

• A Wiro API key — Authentication.
• A deployed agent — Agent Overview.
• A Firebase project with your iOS and/or Android apps registered and FCM enabled.

Setup

Step 1: Generate a Firebase Admin SDK service account

1. console.firebase.google.com → select project.
2. Project settings → Service accounts → Firebase Admin SDK → Generate new private key.
3. Save the JSON file.

Step 2: Base64-encode the JSON

# Linux
base64 -w 0 firebase-service-account.json > firebase-sa.b64

# macOS
base64 -b 0 firebase-service-account.json > firebase-sa.b64

Step 3: Save to Wiro

curl -X POST "https://api.wiro.ai/v1/UserAgent/CredentialUpsert" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "useragentguid": "your-useragent-guid",
    "fields": [
      { "credentialkey": "firebase", "parentfield": "accounts", "ordinal": 0, "fieldname": "appname",                  "fieldvalue": "My App" },
      { "credentialkey": "firebase", "parentfield": "accounts", "ordinal": 0, "fieldname": "serviceaccountjson", "fieldvalue": "eyJ0eXBlIjoic2VydmljZV9hY2NvdW50Ii..." },
      { "credentialkey": "firebase", "parentfield": "accounts.0.apps", "ordinal": 0, "fieldname": "platform", "fieldvalue": "ios" },
      { "credentialkey": "firebase", "parentfield": "accounts.0.apps", "ordinal": 0, "fieldname": "id",       "fieldvalue": "6479306352" },
      { "credentialkey": "firebase", "parentfield": "accounts.0.apps", "ordinal": 1, "fieldname": "platform", "fieldvalue": "android" },
      { "credentialkey": "firebase", "parentfield": "accounts.0.apps", "ordinal": 1, "fieldname": "id",       "fieldvalue": "com.example.app" },
      { "credentialkey": "firebase", "parentfield": "accounts.0.topics", "ordinal": 0, "fieldname": "topickey",  "fieldvalue": "locale_en" },
      { "credentialkey": "firebase", "parentfield": "accounts.0.topics", "ordinal": 0, "fieldname": "topicdesc", "fieldvalue": "English users" },
      { "credentialkey": "firebase", "parentfield": "accounts.0.topics", "ordinal": 1, "fieldname": "topickey",  "fieldvalue": "tier_paid" },
      { "credentialkey": "firebase", "parentfield": "accounts.0.topics", "ordinal": 1, "fieldname": "topicdesc", "fieldvalue": "Paid subscribers" }
    ]
  }'

Step 4: Start the agent

curl -X POST "https://api.wiro.ai/v1/UserAgent/Start" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{ "guid": "your-useragent-guid" }'

Credential Fields

credentials.firebase.accounts[] is an array. Each account object:

Multi-project setups

Add more entries to accounts[] to manage multiple Firebase projects from one agent. Each new account is just a higher ordinal in the same accounts parent, with its nested apps and topics addressed via accounts.{N}.apps / accounts.{N}.topics:

curl -X POST "https://api.wiro.ai/v1/UserAgent/CredentialUpsert" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "useragentguid": "your-useragent-guid",
    "fields": [
      { "credentialkey": "firebase", "parentfield": "accounts", "ordinal": 0, "fieldname": "appname", "fieldvalue": "Consumer App" },
      { "credentialkey": "firebase", "parentfield": "accounts", "ordinal": 0, "fieldname": "serviceaccountjson", "fieldvalue": "eyJ0eXBlIjoic2VydmljZV9hY2NvdW50Ii..." },
      { "credentialkey": "firebase", "parentfield": "accounts.0.apps", "ordinal": 0, "fieldname": "platform", "fieldvalue": "ios" },
      { "credentialkey": "firebase", "parentfield": "accounts.0.apps", "ordinal": 0, "fieldname": "id", "fieldvalue": "6479306352" },
      { "credentialkey": "firebase", "parentfield": "accounts.0.topics", "ordinal": 0, "fieldname": "topickey", "fieldvalue": "locale_en" },
      { "credentialkey": "firebase", "parentfield": "accounts.0.topics", "ordinal": 0, "fieldname": "topicdesc", "fieldvalue": "English users" },

      { "credentialkey": "firebase", "parentfield": "accounts", "ordinal": 1, "fieldname": "appname", "fieldvalue": "Business App" },
      { "credentialkey": "firebase", "parentfield": "accounts", "ordinal": 1, "fieldname": "serviceaccountjson", "fieldvalue": "eyJ0eXBlIjoic2VydmljZV9hY2NvdW50Ii..." },
      { "credentialkey": "firebase", "parentfield": "accounts.1.apps", "ordinal": 0, "fieldname": "platform", "fieldvalue": "android" },
      { "credentialkey": "firebase", "parentfield": "accounts.1.apps", "ordinal": 0, "fieldname": "id", "fieldvalue": "com.example.business" },
      { "credentialkey": "firebase", "parentfield": "accounts.1.topics", "ordinal": 0, "fieldname": "topickey", "fieldvalue": "tier_paid" },
      { "credentialkey": "firebase", "parentfield": "accounts.1.topics", "ordinal": 0, "fieldname": "topicdesc", "fieldvalue": "Paid subscribers" }
    ]
  }'

Wiro's merge logic uses positional indexes — sending accounts ordinal 2 while the agent has 1 account creates a new account entry at index 2 populated with the field rows you supply.

Runtime Behavior

The int-firebase-push skill is active only when it is enabled and accounts is non-empty. For each saved account it uses the project ID from that account's service account, plus the app name, topics ({ topickey: topicdesc }) and apps ({ platform, id }) you saved.

Auth: FCM HTTP v1 Authorization: Bearer <token> — tokens minted from the account's service account.

Base URL: https://fcm.googleapis.com/v1/projects/<PROJECT_ID>/messages:send

Troubleshooting

• "invalid JWT signature": Service account JSON corrupt or truncated. Re-export from Firebase Console and re-encode.
• No devices receive notifications: Verify topics are subscribed on the client side and the topic name matches exactly. Check that the topic is listed in that account's topics.
• Rate limits: FCM supports up to 600,000 messages/minute per project for HTTP v1 API (see the int-firebase-push skill for topic/condition specifics). Higher volumes require a support request to Google Cloud.

Related

• Agent Credentials & OAuth
• Agent Overview
• Agent Skills
• Firebase Cloud Messaging docs