Prerequisites

  • Vocera API key
  • Agent ID
  • Development environment for your chosen framework

URL Structure

The embed URL follows this pattern:

https://dashboard.vocera.ai/embed/{agentId}/overview?token={token}

Where:

  • {agentId}: Your agent’s unique identifier
  • {token}: Your authentication token

Framework Implementations

import { useEffect, useState } from 'react';

const VoceraOverviewEmbed = ({ agentId }) => {
  const [token, setToken] = useState(null);
  const [isLoading, setIsLoading] = useState(true);
  const [error, setError] = useState(null);

  useEffect(() => {
    const handleMessage = async (event) => {
      // Token expired event
      if (event.data === 'token_expired') {
        try {
          await refreshToken(); // See /embed/refreshing-expired-token for implementation
        } catch (err) {
          setError('Failed to refresh token');
        }
      }
     
    };

    const initializeToken = async () => {
      try {
        const newToken = await initToken(); // See /embed/generate-token for implementation
        setToken(newToken);
      } catch (err) {
        setError('Failed to initialize token');
      }
    };

    window.addEventListener('message', handleMessage);
    initializeToken();

    return () => window.removeEventListener('message', handleMessage);
  }, [agentId]);

  if (error) return <div className="error-message">{error}</div>;
  if (!token || isLoading) return <div className="loading-state">Loading...</div>;

  return (
    <iframe
      src={`https://dashboard.vocera.ai/embed/${agentId}/overview?token=${token}`}
      className="w-full h-[950px] border-0"
      allowFullScreen
      loading="lazy"
      title="Vocera Overview Embed"
    />
  );
};

export default VoceraOverviewEmbed;

Event Handling

Each framework implementation above includes handlers for these core events:

// Token expired event
if (event.data === 'token_expired') {
  await refreshToken(); // See /embed/refreshing-expired-token for implementation
}

For token management implementation details, refer to: