EngageLab SMS API Skill

This skill enables you to interact with the EngageLab SMS REST API. It covers three areas:

1. 1. Send SMS — Send notification or marketing SMS to one or more recipients
2. Template Management — Create, read, update, and delete SMS templates
3. Signature (Sender ID) Management — Create, read, update, and delete sender ID signatures

Resources

scripts/

• - sms_client.py — Python client class (EngageLabSMS) wrapping all API endpoints: send_sms() (immediate and scheduled), template CRUD (list_templates(), get_template(), create_template(), update_template(), delete_template()), and signature CRUD (list_signatures(), get_signature(), create_signature(), update_signature(), delete_signature()). Handles authentication, request construction, and typed error handling. Use as a ready-to-run helper or import into the user's project.

references/

• - template-and-signature-api.md — Full request/response field specs for all template and signature endpoints
• error-codes.md — Complete error code tables for SMS sending and template/signature operations

Authentication

All EngageLab SMS API calls use HTTP Basic Authentication.

• - Base URL: INLINECODE15
• Header: INLINECODE16
• Content-Type: INLINECODE17

The user must provide their dev_key and dev_secret (also called apikey and apisecret). Encode them as base64("dev_key:dev_secret") and set the Authorization header.

Example (using curl):

CODEBLOCK0

If the user hasn't provided credentials, ask them for their dev_key and dev_secret before generating API calls.

Quick Reference — All Endpoints

Sending SMS

Endpoint: INLINECODE48

Request Body

CODEBLOCK1

Parameters

Template Variables

If the template contains {{var}} placeholders, populate them via params. For example, for template content "Hi {{name}}, your code is {{code}}", pass:

CODEBLOCK2

Unpopulated variables are sent literally as {{var}}.

Response

Success (single target):

CODEBLOCK3

Success (scheduled):

CODEBLOCK4

Error: Contains code (non-zero) and message fields alongside plan_id.

For the full error code table, read references/error-codes.md.

Template Management

Templates define the SMS content. Each template must pass review before it can be used for sending.

For full request/response details and field descriptions, read references/template-and-signature-api.md.

Key Rules

• - Template content cannot contain: 【, 】, 、, 测试, test, [, INLINECODE79
• After creation or update, templates enter Pending Review status (status=1) and cannot be used until Approved (status=2)
• Templates in Pending Review cannot be updated
• Templates tied to pending/running message plans cannot be updated or deleted
• Template types: utility (notification), marketing (marketing)

CRUD Summary

Create — INLINECODE82

CODEBLOCK5

List all — GET /v1/template-configs (returns array)

Get one — INLINECODE84

Update — PUT /v1/template-configs/:templateId (same body as create, all fields required)

Delete — INLINECODE86

Signature (Sender ID) Management

Signatures identify the sender and are attached to templates. They also go through a review process.

For full request/response details and field descriptions, read references/template-and-signature-api.md.

Key Rules

• - Signature name: 2–60 characters, cannot contain 【, 】, [, INLINECODE91
• Names must be unique within the same business
• After creation or update, signatures enter Pending Review (status=1)
• Signatures in Pending Review cannot be updated
• Signatures tied to pending/running plans cannot be updated or deleted

CRUD Summary

Create — INLINECODE92

CODEBLOCK6

List all — GET /v1/sign-configs (returns array)

Get one — INLINECODE94

Update — PUT /v1/sign-configs/:signId (same body as create)

Delete — INLINECODE96

Generating Code

When the user asks to send SMS or manage templates/signatures, generate working code. Default to curl unless the user specifies a language. Supported patterns:

• - curl — Shell commands with proper auth header
• Python — Using requests library
• Node.js — Using fetch or INLINECODE100
• Java — Using INLINECODE101
• Go — Using INLINECODE102

Always include the authentication header and proper error handling. Use placeholder values like YOUR_DEV_KEY and YOUR_DEV_SECRET if the user hasn't provided credentials.

Status Codes Reference