SDK Troubleshooting

// The send is accepted even when the recipient has opted out.
const response = await client.messages.send({
  to: ['+1234567890'],
  template: {
    id: '7ba7b820-9dad-11d1-80b4-00c04fd430c8',
    name: 'welcome'
  }
});

const messageId = response.data.recipients[0].message_id;

// The block arrives on the message.filtered webhook. For a one-off check,
// read the status back once the message is finalized.
const message = await client.messages.retrieveStatus(messageId);

if (message.data.status === 'FILTERED') {
  // FILTERED also covers routing deny rules, so confirm the opt-out on the
  // contact record before mirroring it into your own database.
  const contacts = await client.contacts.list({ phone: '+1234567890' });

  if (contacts.data.contacts[0]?.opt_out) {
    await db.users.update({
      where: { phone: '+1234567890' },
      data: { messagingOptOut: true }
    });
    console.log('Recipient opted out, skipping future sends');
  }
}

# The send is accepted even when the recipient has opted out.
response = client.messages.send(
    to=['+1234567890'],
    template={
        'id': '7ba7b820-9dad-11d1-80b4-00c04fd430c8',
        'name': 'welcome'
    }
)

message_id = response.data.recipients[0].message_id

# The block arrives on the message.filtered webhook. For a one-off check,
# read the status back once the message is finalized.
message = client.messages.retrieve_status(message_id)

if message.data.status == 'FILTERED':
    # FILTERED also covers routing deny rules, so confirm the opt-out on the
    # contact record before mirroring it into your own database.
    contacts = client.contacts.list(phone='+1234567890')

    if contacts.data.contacts and contacts.data.contacts[0].opt_out:
        db.users.update(
            phone='+1234567890',
            messaging_opt_out=True
        )
        print('Recipient opted out, skipping future sends')

// Try sending (may throw if template not approved)
try {
  const response = await client.messages.send({
    to: ['+1234567890'],
    template: {
      id: '7ba7b820-9dad-11d1-80b4-00c04fd430c8',
      name: 'welcome'
    }
  });

  console.log('Sent:', response.data.recipients[0].message_id);
} catch (error) {
  if (error instanceof SentDm.BadRequestError &&
      error.message.includes('not approved')) {
    console.log('Template not approved yet');

    // Queue for later or use alternative channel
    await db.queuedMessages.create({
      phoneNumber: '+1234567890',
      templateId: 'welcome-template',
      retryAfter: new Date(Date.now() + 3600000), // 1 hour
      status: 'pending_approval'
    });
  }
}

from sent_dm import BadRequestError

# Try sending (may raise if template not approved)
try:
    response = client.messages.send(
        to=['+1234567890'],
        template={
            'id': '7ba7b820-9dad-11d1-80b4-00c04fd430c8',
            'name': 'welcome'
        }
    )

    print(f'Sent: {response.data.recipients[0].message_id}')
except BadRequestError as e:
    if 'not approved' in str(e):
        print('Template not approved yet')

        # Queue for later or use alternative channel
        db.queued_messages.create(
            phone_number='+1234567890',
            template_id='welcome-template',
            retry_after=datetime.now() + timedelta(hours=1),
            status='pending_approval'
        )

try {
  const response = await client.messages.send({
    to: ['+1234567890'],
    template: {
      id: '7ba7b820-9dad-11d1-80b4-00c04fd430c8',
      name: 'welcome'
    }
  });
} catch (error) {
  if (error instanceof SentDm.BadRequestError &&
      error.message.includes('credits')) {
    // Queue for later
    await db.messageQueue.create({
      ...messageData,
      status: 'pending_credits'
    });

    await notifyOpsTeam('Account balance low');
  }
}

from sent_dm import BadRequestError

try:
    response = client.messages.send(
        to=['+1234567890'],
        template={
            'id': '7ba7b820-9dad-11d1-80b4-00c04fd430c8',
            'name': 'welcome'
        }
    )
except BadRequestError as e:
    if 'credits' in str(e):
        # Queue for later
        db.message_queue.create(
            status='pending_credits',
            **message_data
        )

        notify_ops_team('Account balance low')

const client = new SentDm({
  timeout: 60000  // 60 seconds
});

from sent_dm import Sent

client = Sent(timeout=60.0)  # 60 seconds

client := sentdm.NewClient(
    option.WithTimeout(60 * time.Second),
)

class CircuitBreaker {
  private failures = 0;
  private lastFailureTime?: number;
  private readonly threshold = 5;
  private readonly timeout = 60000;

  async execute<T>(fn: () => Promise<T>): Promise<T> {
    if (this.isOpen()) {
      throw new Error('Circuit breaker is open');
    }

    try {
      const result = await fn();
      this.onSuccess();
      return result;
    } catch (error) {
      this.onFailure();
      throw error;
    }
  }

  private isOpen(): boolean {
    if (this.failures < this.threshold) return false;
    if (!this.lastFailureTime) return false;
    return Date.now() - this.lastFailureTime < this.timeout;
  }

  private onSuccess() {
    this.failures = 0;
  }

  private onFailure() {
    this.failures++;
    this.lastFailureTime = Date.now();
  }
}

# Set environment variable
export SENT_LOG=debug

const client = new SentDm({
  logLevel: 'debug'  // 'debug', 'info', 'warn', 'error', 'off'
});

# Set environment variable
export SENT_LOG=debug

import logging

logging.basicConfig(level=logging.DEBUG)
logger = logging.getLogger('sent_dm')
logger.setLevel(logging.DEBUG)

// Use the debug option
client := sentdm.NewClient(
    option.WithDebugLog(nil),
)

# Set the SENT_LOG environment variable
SENT_LOG=debug java -jar myapp.jar

try {
  const response = await client.messages.send({
    to: ['+1234567890'],
    template: {
      id: '7ba7b820-9dad-11d1-80b4-00c04fd430c8',
      name: 'welcome'
    }
  });
  console.log('Message sent:', response.data.recipients[0].message_id);
} catch (error) {
  if (error instanceof SentDm.APIError) {
    console.log('Request ID:', error.headers.get('x-request-id'));
    console.log('Status:', error.status);
    console.log('Message:', error.message);
    // Include these in support tickets!
  }
}

from sent_dm import APIStatusError

try:
    response = client.messages.send(
        to=['+1234567890'],
        template={
            'id': '7ba7b820-9dad-11d1-80b4-00c04fd430c8',
            'name': 'welcome'
        }
    )
    print(f'Message sent: {response.data.recipients[0].message_id}')
except APIStatusError as e:
    print(f'Request ID: {e.response.headers.get("x-request-id")}')
    print(f'Status: {e.status_code}')
    print(f'Message: {str(e)}')
    # Include these in support tickets!

response, err := client.Messages.Send(ctx, params)
if err != nil {
    var apiErr *sentdm.Error
    if errors.As(err, &apiErr) {
        fmt.Printf("Request ID: %s\n", apiErr.Response.Header.Get("x-request-id"))
        fmt.Printf("Status: %d\n", apiErr.StatusCode)
        fmt.Printf("Message: %s\n", apiErr.Error())
        // Include these in support tickets!
    }
} else {
    fmt.Printf("Message sent: %s\n", response.Data.Recipients[0].MessageID)
}