Como usar?
Vincular número
Conecte seu número ou qualquer outro através de um código QR para testes
Teste os métodos da API
Comece em apenas 1 minuto, graças a uma ferramenta conveniente para desenvolvedores
Configure seu Webhook
Escolha e configure os hooks para qualquer evento no WhatsApp para enviar e receber mensagens e outros eventos
O que é Whapi.Cloud?
Simples e poderoso! Whapi.Cloud é uma API intuitiva que permite conectar seu negócio ao WhatsApp de forma integrada.
Com Whapi.Cloud, você pode focar no que realmente importa – fazer seu negócio crescer.
Desfrute de infinitas possibilidades de integração, como criar bots de suporte, agendar compromissos, enviar notificações do WhatsApp e muito mais.
Além disso, monitore tudo sem esforço com webhooks. Começar nunca foi tão fácil!
Tudo o que você precisa para criar automações no WhatsApp
O Whapi.Cloud oferece acesso a um conjunto completo de recursos do WhatsApp — mensagens, mídia, grupos, canais, webhooks e muito mais. Crie bots, automações e integrações sem limitações de funcionalidades.
Documentação do WhatsApp API PHP SDK
Instalação
composer require whapi-cloud/whatsapp-api-sdk-php
Configuração Inicial
use OpenAPI\Client\Api\MessagesApi;
use OpenAPI\Client\Configuration;
// Initialize the client
$config = OpenAPI\Client\Configuration::getDefaultConfiguration()
->setApiKey('token', "your_token")
->setAccessToken("your_token");
$apiInstance = new OpenAPI\Client\Api\MessagesApi(
new GuzzleHttp\Client(),
$config
);
API de Mensagens
Enviando Mensagens de Texto
// Create text message object
$sender_text = new \OpenAPI\Client\Model\SenderText();
$sender_text->setTo('13016789891'); // Include country code
$sender_text->setBody('Your message here'); // Message content
// Optional parameters
$sender_text->setEphemeral(3600); // Message visibility time in seconds
$sender_text->setViewOnce(true); // View once setting
$sender_text->setTypingTime(5.0); // Typing simulation duration
$sender_text->setNoLinkPreview(false); // Enable/disable link previews
// Send the message
$result = $apiInstance->sendMessageText($sender_text);
print_r($result);
Enviando Imagens com Legendas
// Create image message object
$sender_image = new \OpenAPI\Client\Model\SenderImage();
$sender_image->setTo('13016789891'); // Recipient's number
$sender_image->setCaption('Image caption');
$sender_image->setMedia('https://example.com/image.jpg');
// Send the image
$result = $apiInstance->sendMessageImage($sender_image);
print_r($result);
Recuperando Mensagens
Obter Múltiplas Mensagens
// Parameters
$count = 100; // Number of messages to retrieve
$offset = 0; // Pagination offset
// Get messages
$result = $apiInstance->getMessages($count, $offset);
print_r($result);
Obter Mensagem Única
// Get message by ID
$message_id = "your_message_id";
$result = $apiInstance->getMessage($message_id);
print_r($result);
API de Grupos do WhatsApp
Criando Grupos
$apiInstance = new OpenAPI\Client\Api\GroupsApi(
new GuzzleHttp\Client(),
$config
);
// Create group request
$create_group_request = [
"subject" => "Group Name",
"participants" => [
"13016789891",
"13016789892"
]
];
// Create the group
$result = $apiInstance->createGroup($create_group_request);
print_r($result);
Notas Importantes
- Números de Telefone:
- Sempre inclua o código do país (por exemplo, '13016789891' para número dos EUA)
- Não use caracteres especiais ou espaços
- URLs de Mídia:
- Devem ser acessíveis publicamente
- Compatível com formatos comuns de imagem (JPEG, PNG, etc.)
- Opções de Mensagem:
- Efêmero: Tempo em segundos antes que a mensagem desapareça
- VerUmaVez: A mensagem só pode ser visualizada uma vez
- TempoDeDigitação: Simula o atraso natural na digitação
Tratamento de Erros
try {
$result = $apiInstance->sendMessageText($sender_text);
print_r($result);
} catch (Exception $e) {
echo "Error: " . $e->getMessage();
}
- Evite enviar muitas mensagens em rápida sucessão
- Implemente um tratamento de erros adequado
- Armazene e gerencie os IDs das mensagens para acompanhamento
- Monitore regularmente as respostas da API
- Mantenha registros adequados para depuração