seven.io PHP SDK

📦 Installation

Via Composer (recommended)

composer require seven.io/api

Manual Installation

🚀 Quick Start

Send your first SMS

<?phprequire'vendor/autoload.php';useSeven\Api\Client;useSeven\Api\Resource\Sms\SmsParams;useSeven\Api\Resource\Sms\SmsResource;// Initialize the client with your API key$client =newClient('YOUR_API_KEY');// Create SMS resource$smsResource =newSmsResource($client);// Send SMS$response =$smsResource->dispatch(newSmsParams('Hello from seven.io!','+491234567890'));echo"SMS sent successfully! ID:" .$response->getMessages()[0]->getId();

📱 Features

SMS Messaging

Voice Calls

Number Lookup

Other Features

💻 Usage Examples

Send SMS with custom sender

$params = (newSmsParams('Your message here','+491234567890'))    ->setFrom('YourBrand')    ->setUnicode(true)    ->setFlash(false);$response =$smsResource->dispatch($params);

Send bulk SMS

$params =newSmsParams('Bulk message to multiple recipients',    ['+491234567890','+491234567891','+491234567892']);$response =$smsResource->dispatch($params);

Schedule SMS for later

$params = (newSmsParams('Scheduled message','+491234567890'))    ->setDelay(new \DateTime('+1 hour'));$response =$smsResource->dispatch($params);

Perform HLR lookup

useSeven\Api\Resource\Lookup\LookupResource;$lookupResource =newLookupResource($client);$results =$lookupResource->hlr('+491234567890');$hlr =$results[0];echo"Current Carrier:" .$hlr->getCurrentCarrier()->getName() ."\n";echo"Country:" .$hlr->getCountryName() ."\n";echo"Reachable:" .$hlr->getReachable() ."\n";echo"Ported:" .$hlr->getPorted() ."\n";

Check account balance

useSeven\Api\Resource\Balance\BalanceResource;$balanceResource =newBalanceResource($client);$balance =$balanceResource->get();echo"Current balance: €" .$balance->getAmount();

Text-to-Speech call

useSeven\Api\Resource\Voice\VoiceResource;useSeven\Api\Resource\Voice\VoiceParams;$voiceResource =newVoiceResource($client);$params =newVoiceParams('+491234567890','Hello, this is a test call');$response =$voiceResource->call($params);

🔧 Advanced Configuration

Initialize with signing secret (for webhook validation)

$client =newClient(    apiKey:'YOUR_API_KEY',    signingSecret:'YOUR_SIGNING_SECRET');

Error Handling

useSeven\Api\Exception\ApiException;useSeven\Api\Exception\InvalidApiKeyException;useSeven\Api\Exception\MissingAccessRightsException;useSeven\Api\Exception\ForbiddenIpException;try {$response =$smsResource->dispatch($params);}catch (InvalidApiKeyException$e) {echo"Invalid API key provided";}catch (MissingAccessRightsException$e) {echo"Missing access rights for this operation";}catch (ForbiddenIpException$e) {echo"Your IP address is not allowed";}catch (ApiException$e) {// Handles all other API error codes (100-903)// Common codes: 500 = Insufficient credit, 201 = Invalid sender, 202 = Invalid recipientecho"API Error:" .$e->getMessage() ." (Code:" .$e->getCode() .")";}catch (\Exception$e) {echo"Error:" .$e->getMessage();}

API Error Codes

🧪 Testing

# Using production API keySEVEN_API_KEY=your_api_key php vendor/bin/phpunit tests# Using sandbox API keySEVEN_API_KEY_SANDBOX=your_sandbox_key php vendor/bin/phpunit tests

Run specific tests

# Test only SMS functionalityphp vendor/bin/phpunit tests/SmsTest.php# Test with verbose outputphp vendor/bin/phpunit tests --verbose

📚 API Resources

🔑 Environment Variables

📄 Requirements

🤝 Contributing

🆘 Support

📜 License