README

Cliente PHP para comunicação com uma API de WhatsApp hospedada pela Facilie.

O pacote não realiza conexão direta com o WhatsApp. Ele envia requisições HTTPS para uma instância configurada da API.

Requisitos

PHP 7.4 ou superior
Extensão PHP cURL
Extensão PHP JSON
Composer

Instalação

composer require facilie/whatsapp-api-client

Configuração

<?php

use Facilie\WhatsApp\WhatsApp;

require_once __DIR__ . '/vendor/autoload.php';

$whatsapp = new WhatsApp([
    'server' => 'https://wa-api.facilie.com.br',
    'key' => 'SUA_CHAVE_DA_API',
]);

Não coloque a chave da API em arquivos públicos ou versionados no Git.

Consultar a conexão

$status = $whatsapp->status();

var_dump($status);

Exemplo de resposta:

[
    'success' => true,
    'status' => 'connected',
    'connected' => true,
    'number' => '5569999999999',
    'hasQrCode' => false,
]

Enviar mensagem de texto

$result = $whatsapp->sendText(
    '5569999999999',
    'Olá!'
);

$messageId = $result['message']['messageId'] ?? null;

O número deve conter o código do país e o DDD, usando somente números.

Consultar o estado de uma mensagem

$status = $whatsapp->messageStatus($messageId);

var_dump($status);

Estados possíveis:

pending: aguardando confirmação
sent: aceita pelo servidor
delivered: entregue ao destinatário
read: lida pelo destinatário
played: áudio reproduzido
failed: falha no envio

Tratamento de erros

try {
    $result = $whatsapp->sendText(
        '5569999999999',
        'Mensagem de teste'
    );
} catch (Throwable $exception) {
    error_log(
        'Erro ao enviar mensagem: ' . $exception->getMessage()
    );
}

Licença

MIT

facilie / whatsapp-api-client

Package info

Security

Statistics