Pingram Technical Reference

website·Indexed 33 days ago

https://www.pingram.io/docs

A unified messaging API platform, formerly known as NotificationAPI, designed for sending and receiving messages, with specific support for AI coding assistants.

Tokens
881
Snippets
6
Records
8
Agent score
19%

What's inside Pingram

  1. Overview of Pingram Unified Messaging API

    Pingram (formerly NotificationAPI) is a unified messaging platform that allows developers to send and receive emails, SMS, voice calls, and in-app messages through a single API. It eliminates the need for separate providers like Twilio, SendGrid, or Amazon SES by providing built-in delivery infrastructure and managing regulatory compliance, including A2P 10DLC for SMS and DKIM/SPF/DMARC for email.
  2. Overview of Pingram Unified Messaging API

    Pingram (formerly NotificationAPI) is a unified messaging platform that replaces the need for multiple separate providers like Twilio, SendGrid, or AWS SES. It provides a single dependency for sending emails, SMS, and voice calls, handling infrastructure requirements such as SMTP servers, carrier registration, and compliance (A2P 10DLC, DKIM/SPF/DMARC). It offers a free tier of 3,000 messages per month without requiring a credit card and supports major languages including Node.js, Python, PHP, Go, C#, Java, and Ruby.
  3. Install Pingram SDKs for different languages

    Pingram provides official SDKs for several popular programming languages to simplify integration.
    # Node.js
    npm install pingram
    
    # Python
    pip install pingram
  4. Process inbound emails and SMS via webhooks

    Pingram can receive inbound messages and forward them to a developer-defined webhook. This is typically used for AI-powered support bots or conversational workflows.
    // Webhook handler for inbound emails
    app.post('/webhook/inbound-email', (req, res) => {
      const { from, subject, body, attachments } = req.body;
      // Process with your AI pipeline
      const response = await ai.processEmail({ from, subject, body });
      res.json({ status: 'ok' });
    });
  5. Send SMS messages via Pingram

    Pingram provides a global SMS API supporting 200+ countries. It manages A2P 10DLC registration and compliance automatically, removing the need for manual carrier paperwork. It also supports RCS (beta) and inbound SMS processing via webhooks.
    await pingram.sms.send({
      type: "otp",
      to: "+15005550000",
      message: "Your verification code is 123456"
    });
  6. Make automated voice calls via Pingram

    The Voice API allows for automated calls with text-to-speech in multiple languages and voice recognition for interactive responses. Built-in infrastructure replaces the need for external voice providers.
    await pingram.send({
      type: "alert",
      to: { number: "+15005550000" },
      call: { message: "Critical alert: your server is down." }
    });
  7. Send emails using the Pingram Node.js and Python SDKs

    Use the Pingram SDK to send transactional emails. The API handles SMTP delivery and compliance with Google/Yahoo bulk sender policies. You can provide raw HTML or use predefined message types.
    import Pingram from 'pingram';
    const pingram = new Pingram({ apiKey: 'YOUR_API_KEY' });
    
    await pingram.email.send({
      type: "welcome",
      to: "user@example.com",
      subject: "Welcome to our platform",
      html: "<p>Hello! Your account is ready.</p>"
    });
    import asyncio
    from pingram import Pingram
    from pingram.models import SendEmailRequest
    
    async def send_email():
        async with Pingram(api_key="YOUR_API_KEY") as client:
            await client.email.email_send(
                SendEmailRequest(
                    type="welcome",
                    to="user@example.com",
                    subject="Welcome to our platform",
                    html="<p>Hello! Your account is ready.</p>",
                )
            )
    
    asyncio.run(send_email())
  8. Implement In-App Notifications with React

    Pingram provides a pre-built React notification center component that delivers messages in real-time via WebSockets. It supports marking messages as read/unread and pagination.
    import { NotificationFeed } from '@pingram/react';
    <NotificationFeed userId="user123" />