Skip to content
Go to Customer Portal
  • There are no suggestions because the search field is empty.

General Setup Guide: Curogram Press‑to‑Text API Integration

The Curogram Press-to-Text Integration allows your practice to automatically send text messages to patients directly from your phone system (VoIP) with a simple button press.


This guide will walk you through the setup process for connecting your existing VoIP platform—such as RingCentral, Dialpad, or similar systems to Curogram's Press-to-Text API.

Who This Is For

IT administrators and office managers who manage call flows/Interactive Voice Response (IVR) menus and want callers to receive a text message on demand.

Prerequisites

  • Curogram account with the Press-to-Text feature enabled. (If it’s not enabled, please contact our support team or you may enable it thru the app.

  • API endpoint from Curogram. In Curogram: Settings → Integrations → Press‑to‑Text to view your Endpoint URL .

  • Admin access to your VoIP provider’s IVR/Call Flow and Webhook/HTTP settings.

Note: Your endpoint URL is unique to your organization. Do not share it publicly.

How It Works (At a Glance)

  1. A caller navigates your IVR and selects the Press‑to‑Text option.

  2. Your VoIP system sends an HTTP POST request to your Curogram endpoint with the caller’s phone number.

  3. Curogram receives the request, identifies the patient/contact (if applicable), and sends the appropriate text message template.

 

STEP-BY-STEP INSTRUCTIONS

Step 1: Obtain Your Curogram Endpoint

  1. Open Curogram → Settings →VoIP Notification → Press‑to‑Text.

  2. Copy the Endpoint URL.

If you don’t see an endpoint, contact Curogram Support

Step 2: Configure Your VoIP HTTP/Webhook Action

In your VoIP admin portal, find the feature that lets you send a webhook or HTTP request as part of a call flow/IVR. Typical names include Webhook, HTTP Request, External URL, or Outbound POST.

HTTP Request Specification

  • URL: Your unique Curogram endpoint (from Step 1)

  • Method: POST

  • Headers:

    • Content-Type: application/json

  • Body (JSON): Must include the caller’s phone number. 
    {

    "caller_number": "+15551234567"

    }

Step 3: Decide When to Trigger the POST

Create an IVR option (e.g., “Press 2 to receive a text message”) that triggers the HTTP POST.

  • RingCentral: In Phone System → Auto‑Receptionist → IVR Menus, add/edit a menu option → Webhook/External Service (or equivalent) → configure the POST as above.

  • Dialpad: In Admin → Main Line/Departments → Call Routing/IVR, add a Custom Action/Webhook on key press → configure the POST.

  • Other providers: Look for HTTP Request, Webhook, or External URL actions within IVR or post‑call automations.

The exact labels vary by provider. If no webhook is available, check if your provider supports Zapier/Make style connectors to send an HTTP POST.

 

Step 4: Test the Integration

  1. Call your main practice number.

  2. Use the IVR to select the Press‑to‑Text option.

  3. Confirm the caller receives the expected text message from Curogram.

  4. In Curogram, review Integration Logs (if available) to verify that the request was received and processed.

Step 5: Troubleshooting

  • No text received

    • Confirm your VoIP system allows outbound POST requests.

    • Verify the endpoint URL and authentication headers.

    • Ensure JSON includes caller_number and is valid JSON.

    • Confirm the phone number format .

  • HTTP 401/403 (Unauthorized/Forbidden)

    • Check your API key/token and header name/value.

    • Make sure you’re calling your organization’s endpoint.

  • HTTP 4xx (Client Error)

  • Validate JSON structure and required fields.

  • Remove trailing commas and smart quotes 

    For further assistance, please contact your VOIP administrator or provider.