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?
Whapi.Cloud é um avançado gateway de API do WhatsApp projetado para otimizar soluções de mensagens para empresas e desenvolvedores. Ele permite integração perfeita com ferramentas para automatizar fluxos de trabalho, gerenciar grupos, enviar mensagens em massa e melhorar interações com clientes de forma eficiente.
Projetado para ser flexível, o Whapi.Cloud oferece recursos poderosos além da API oficial, como suporte para gestão de comunidades e atualizações de status personalizadas. Com preços transparentes, documentação robusta e SDKs fáceis de usar, é a escolha ideal para escalar operações no WhatsApp enquanto mantém eficiência e confiabilidade.
Confira a API do WhatsApp
Atualizamos regularmente novas funcionalidades para melhorar sua experiência. Se você está procurando uma funcionalidade ausente, entre em contato com nossa equipe de suporte.
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