waga

package module

Go to main page

Versions in this module

v0

v0.7.0

Jul 15, 2026

Changes in this version

+ const DefaultAdminBaseURL

+ var ErrGone = &SDKError

+ var ErrNotModified = &SDKError

+ var ErrUnknownWebhookEvent = errors.New("unknown webhook event")

+ func IsGone(err error) bool

+ type AdminClient struct

+ func NewAdminClient(opts ...Option) *AdminClient

+ func (a *AdminClient) Live(ctx context.Context) (*HealthResponse, error)

+ func (a *AdminClient) Ready(ctx context.Context) (*HealthReadyResponse, error)

+ func (a *AdminClient) Session(ctx context.Context, phone string) (*AdminSessionResponse, error)

+ func (a *AdminClient) Sessions(ctx context.Context) (*SessionInventory, error)

+ type AdminSessionResponse struct

+ Instance string

+ Session SessionInventoryItem

+ type AvatarResponse struct

+ DirectPath string

+ ID string

+ JID string

+ Type string

+ URL string

+ type ChatPresenceRequest struct

+ Chat string

+ State string

type Client

+ func (c *Client) CreateGroup(ctx context.Context, req CreateGroupRequest) (*CreateGroupResponse, error)

+ func (c *Client) DeleteGroupPhoto(ctx context.Context, chat string) (*GroupPhotoResponse, error)

+ func (c *Client) GetAvatar(ctx context.Context, chat string, preview bool, priorID ...string) (*AvatarResponse, error)

+ func (c *Client) GetContactInfo(ctx context.Context, chat string) (*ContactInfoResponse, error)

+ func (c *Client) GetGroupInfo(ctx context.Context, chat string) (*GroupInfoResponse, error)

+ func (c *Client) GetGroupInviteInfo(ctx context.Context, code string) (*GroupInfoResponse, error)

+ func (c *Client) GetGroupInviteLink(ctx context.Context, chat string) (*GroupInviteLinkResponse, error)

+ func (c *Client) JoinGroup(ctx context.Context, code string) (*JoinGroupResponse, error)

+ func (c *Client) LeaveGroup(ctx context.Context, chat string) error

+ func (c *Client) LinkSubGroup(ctx context.Context, chat, childJID string) error

+ func (c *Client) ListCommunityParticipants(ctx context.Context, chat string) (*CommunityParticipantsResponse, error)

+ func (c *Client) ListContacts(ctx context.Context, limit, offset int) (*ContactListResponse, error)

+ func (c *Client) ListGroups(ctx context.Context) (*GroupListResponse, error)

+ func (c *Client) ListJoinRequests(ctx context.Context, chat string) (*GroupJoinRequestsResponse, error)

+ func (c *Client) ListSubGroups(ctx context.Context, chat string) (*SubGroupListResponse, error)

+ func (c *Client) MarkRead(ctx context.Context, chat string, messageIDs []string, sender string) error

+ func (c *Client) ResetGroupInviteLink(ctx context.Context, chat string) (*GroupInviteLinkResponse, error)

+ func (c *Client) ReviewJoinRequests(ctx context.Context, chat, action string, participants []string) (*GroupJoinRequestsActionResponse, error)

+ func (c *Client) SendChatPresence(ctx context.Context, chat, state string) error

+ func (c *Client) SetGroupName(ctx context.Context, chat, name string) error

+ func (c *Client) SetGroupPhoto(ctx context.Context, chat string, jpeg io.Reader) (*GroupPhotoResponse, error)

+ func (c *Client) SetGroupSettings(ctx context.Context, chat string, announce, locked *bool) (*GroupSettingsResponse, error)

+ func (c *Client) SetGroupTopic(ctx context.Context, chat, topic string) error

+ func (c *Client) UnlinkSubGroup(ctx context.Context, chat, childJID string) error

+ func (c *Client) UpdateGroupParticipants(ctx context.Context, chat, action string, participants []string) (*GroupParticipantsResponse, error)

+ type CommunityParticipantItem struct

+ JID string

+ type CommunityParticipantsResponse struct

+ Count int

+ Participants []CommunityParticipantItem

+ type ContactInfoResponse struct

+ DeviceCount int

+ JID string

+ LID string

+ PictureID string

+ Status string

+ VerifiedName string

+ type ContactListItem struct

+ BusinessName string

+ FirstName string

+ FullName string

+ JID string

+ PushName string

+ type ContactListResponse struct

+ Contacts []ContactListItem

+ Count int

+ Note string

+ Total int

+ type CreateGroupRequest struct

+ IsAnnounce bool

+ IsCommunity bool

+ IsJoinApprovalRequired bool

+ IsLocked bool

+ LinkedParentJID string

+ Name string

+ Participants []string

+ type CreateGroupResponse struct

+ GroupInfo *GroupInfoResponse

+ GroupJID string

+ Results []ParticipantResult

+ type GroupInfoResponse struct

+ IsAnnounce bool

+ IsCommunity bool

+ IsEphemeral bool

+ IsLocked bool

+ JID string

+ Name string

+ OwnerJID string

+ ParticipantCount int

+ Participants []GroupParticipantItem

+ Topic string

+ type GroupInviteLinkResponse struct

+ Chat string

+ InviteLink string

+ type GroupJoinRequestItem struct

+ JID string

+ RequestedAt string

+ type GroupJoinRequestsActionResponse struct

+ Action string

+ Chat string

+ Results []ParticipantResult

+ type GroupJoinRequestsResponse struct

+ Chat string

+ Count int

+ Requests []GroupJoinRequestItem

+ type GroupListItem struct

+ IsAnnounce bool

+ IsCommunity bool

+ IsLocked bool

+ JID string

+ Name string

+ OwnerJID string

+ ParticipantCount int

+ Topic string

+ type GroupListResponse struct

+ Count int

+ Groups []GroupListItem

+ type GroupParticipantItem struct

+ IsAdmin bool

+ IsSuperAdmin bool

+ JID string

+ LID string

+ PhoneNumber string

+ type GroupParticipantsResponse struct

+ Action string

+ GroupJID string

+ Results []ParticipantResult

+ type GroupPhotoResponse struct

+ PictureID string

+ Removed bool

+ type GroupSettingsResponse struct

+ Applied []string

+ GroupJID string

+ type HealthComponent struct

+ Connected bool

+ Enabled bool

+ type HealthReadyResponse struct

+ Database *HealthComponent

+ Queue *HealthComponent

+ Status string

+ Timestamp string

type IncomingMessage

+ AddressingMode string

type IncomingWebhookPayload

+ AddressingMode string

+ type JoinGroupResponse struct

+ GroupJID string

+ type MarkReadRequest struct

+ Chat string

+ MessageIDs []string

+ Sender string

type Option

+ func WithAdminSecret(secret string) Option

type OutgoingWebhookPayload

+ Error string

+ type ParticipantInvite struct

+ Code string

+ ExpiresAt time.Time

+ type ParticipantResult struct

+ Code int

+ Invite *ParticipantInvite

+ JID string

+ LID string

+ Status string

+ type PresenceState = string

+ const PresenceComposing

+ const PresencePaused

+ const PresenceRecording

type SendLocationMessageRequest

+ Chat string

+ Mentions []string

+ ReplyToID string

+ ReplyToSender string

+ ReplyToText string

type SendMessageResponse

+ Chat string

type SendMessageTextRequest

+ Chat string

+ Mentions []string

+ ReplyToID string

+ ReplyToSender string

+ ReplyToText string

+ type SendOption func(*sendConfig)

+ func WithChat(chat string) SendOption

+ func WithIdempotencyKey(key string) SendOption

+ func WithMentions(mentions ...string) SendOption

+ func WithReply(messageID, sender, quotedText string) SendOption

type SendPollMessageRequest

+ Chat string

+ Mentions []string

+ ReplyToID string

+ ReplyToSender string

+ ReplyToText string

+ type SessionEvent struct

+ Code int

+ Event WebhookEventType

+ ExpiresIn int

+ JID string

+ Message string

+ OnConnect bool

+ PhoneNumber string

+ Reason int

+ ReasonText string

+ Timestamp int64

+ type SessionInventory struct

+ Count int

+ Instance string

+ Sessions []SessionInventoryItem

+ type SessionInventoryItem struct

+ BanExpiresAt *time.Time

+ LastSeen time.Time

+ PhoneMasked string

+ Reason string

+ Source string

+ State string

+ type SubGroupItem struct

+ IsDefaultSubGroup bool

+ JID string

+ Name string

+ type SubGroupListResponse struct

+ Count int

+ SubGroups []SubGroupItem

+ type WebhookEvent struct

+ Event WebhookEventType

+ Incoming *IncomingWebhookPayload

+ Outgoing *OutgoingWebhookPayload

+ Session *SessionEvent

+ type WebhookEventType string

+ const WebhookEventMessageFailed

+ const WebhookEventMessageIncoming

+ const WebhookEventMessageQueued

+ const WebhookEventMessageSent

+ const WebhookEventSessionBanned

+ const WebhookEventSessionConnectFailure

+ const WebhookEventSessionConnected

+ const WebhookEventSessionDisconnected

+ const WebhookEventSessionLoggedOut

+ const WebhookEventSessionReplaced

type WebhookVerifier

+ func (v *WebhookVerifier) ParseWebhook(payload []byte, signature string) (*WebhookEvent, error)

v0.6.0

Jul 5, 2026

Changes in this version

type Client

+ func (c *Client) CheckContact(ctx context.Context, msisdn string) (*ContactCheckResponse, error)

+ func (c *Client) SendAudio(ctx context.Context, msisdn string, audio io.Reader, isPTT, isViewOnce bool) (*SendMessageResponse, error)

+ func (c *Client) SendDocument(ctx context.Context, msisdn string, document io.Reader, ...) (*SendMessageResponse, error)

+ func (c *Client) SendVideo(ctx context.Context, msisdn string, video io.Reader, caption string, ...) (*SendMessageResponse, error)

+ type ContactCheckResponse struct

+ IsOnWhatsApp bool

+ JID string

+ Query string

+ VerifiedName *string

type MessageReactRequest

+ SenderMsisdn string

v0.5.0

Jun 16, 2026

Changes in this version

type IncomingMessageMediaInfo

+ Sha256 string

+ StorageURL string

+ WhatsappURL string

type IncomingMessageType

+ const IncomingMessageTypeContact

+ const IncomingMessageTypeLocation

+ const IncomingMessageTypePoll

+ const IncomingMessageTypeSticker

+ const IncomingMessageTypeUnknown

type IncomingWebhookPayload

+ Address string

+ Latitude *float64

+ Longitude *float64

+ Name string

+ Options []string

+ Question string

+ SelectableCount int

type SDKError

+ TraceID string

type SendMessageResponse

+ JobID string

+ Status string

v0.4.0

Jun 7, 2026

Changes in this version

+ const TraceIDHeader

+ func TraceIDFromContext(ctx context.Context) string

+ func WithTraceID(ctx context.Context, traceID string) context.Context

type Client

+ func (c *Client) GetJobStatus(ctx context.Context, jobID string) (*JobStatusResponse, error)

+ type JobStatusResponse struct

+ CompletedAt *string

+ CreatedAt string

+ Error *string

+ JobID string

+ MessageID *string

+ Status string

v0.3.0

May 27, 2026

Changes in this version

type Client

+ func (c *Client) SendLocation(ctx context.Context, msisdn string, latitude, longitude float64, ...) (*SendMessageResponse, error)

+ func (c *Client) SendPoll(ctx context.Context, msisdn, question string, options []string, ...) (*SendMessageResponse, error)

+ func (c *Client) SendSticker(ctx context.Context, msisdn string, sticker io.Reader) (*SendMessageResponse, error)

+ type SendLocationMessageRequest struct

+ Address string

+ Latitude float64

+ Longitude float64

+ Msisdn string

+ Name string

+ type SendPollMessageRequest struct

+ Msisdn string

+ Options []string

+ Question string

+ SelectableCount int

v0.2.0

May 17, 2026

Changes in this version

type Client

+ func (c *Client) GetIncomingMessages(ctx context.Context, limit int) (*IncomingMessagesResponse, error)

+ type IncomingMessage struct

+ Chat string

+ From string

+ IsGroup bool

+ Media *IncomingMessageMediaInfo

+ MessageId string

+ PushName string

+ Text string

+ Timestamp int

+ Type IncomingMessageType

+ type IncomingMessagesResponse struct

+ Count int

+ Messages []IncomingMessage

+ Success bool

+ Timestamp int64

v0.1.2

Apr 17, 2026

Changes in this version

+ const DefaultBaseURL

+ const DefaultTimeout

+ const DefaultUserAgent

+ const EventMessageFailed

+ const EventMessageIncoming

+ const EventMessageQueued

+ const EventMessageSent

+ const MessageTypeAudio

+ const MessageTypeDocument

+ const MessageTypeImage

+ const MessageTypeText

+ const MessageTypeVideo

+ var ErrBadRequest = &SDKError

+ var ErrConflict = &SDKError

+ var ErrForbidden = &SDKError

+ var ErrInternalServer = &SDKError

+ var ErrInvalidSignature = errors.New("invalid webhook signature")

+ var ErrNotAuthenticated = errors.New("client not authenticated, call Register() or SetToken() first")

+ var ErrNotFound = &SDKError

+ var ErrRateLimited = &SDKError

+ var ErrUnauthorized = &SDKError

+ func ComputeSignature(payload []byte, secret string) string

+ func FormatGroupID(groupID string) string

+ func FormatMSISDN(phoneNumber string) string

+ func IsBadRequest(err error) bool

+ func IsConflict(err error) bool

+ func IsForbidden(err error) bool

+ func IsInternalServer(err error) bool

+ func IsNotFound(err error) bool

+ func IsRateLimited(err error) bool

+ func IsUnauthorized(err error) bool

+ type Client struct

+ func NewClient(opts ...Option) *Client

+ func (c *Client) DeleteMessage(ctx context.Context, msisdn, messageID string) error

+ func (c *Client) EditMessage(ctx context.Context, msisdn, messageID, newMessage string) error

+ func (c *Client) GetLoginStatus(ctx context.Context) (*LoginStatus, error)

+ func (c *Client) GetPairCode(ctx context.Context) (*LoginPairResponse, error)

+ func (c *Client) GetQRCode(ctx context.Context, format string) (*LoginQrResponse, error)

+ func (c *Client) GetToken() string

+ func (c *Client) GetWebhook(ctx context.Context) (*WebhookResponse, error)

+ func (c *Client) Health(ctx context.Context) (*HealthResponse, error)

+ func (c *Client) Logout(ctx context.Context) error

+ func (c *Client) React(ctx context.Context, msisdn, messageID, emoji string) error

+ func (c *Client) Reconnect(ctx context.Context) error

+ func (c *Client) Register(ctx context.Context, phoneNumber, secretKey string) (*RegisterResponse, error)

+ func (c *Client) RegisterWebhook(ctx context.Context, url, hmacSecret string) error

+ func (c *Client) SendImage(ctx context.Context, msisdn string, image io.Reader, caption string, ...) (*SendMessageResponse, error)

+ func (c *Client) SendText(ctx context.Context, msisdn, message string) (*SendMessageResponse, error)

+ func (c *Client) SetToken(token string)

+ func (c *Client) UnregisterWebhook(ctx context.Context) error

+ type ErrorResponse struct

+ Code int

+ Error string

+ type HealthResponse struct

+ Status string

+ Timestamp string

+ type IncomingEventMessage string

+ const IncomingEventMessageMessageIncoming

+ type IncomingMessageMediaInfo struct

+ Caption string

+ Filename string

+ MimeType string

+ Size int

+ Type IncomingMessageType

+ Url string

+ type IncomingMessageType string

+ const IncomingMessageTypeAudio

+ const IncomingMessageTypeDocument

+ const IncomingMessageTypeImage

+ const IncomingMessageTypeText

+ const IncomingMessageTypeVideo

+ type IncomingWebhookPayload struct

+ Chat string

+ Event IncomingEventMessage

+ From string

+ IsGroup bool

+ Media *IncomingMessageMediaInfo

+ MessageId string

+ PushName string

+ Text string

+ Timestamp int

+ Type IncomingMessageType

+ type LoginPairResponse struct

+ ExpiresIn int

+ PairCode string

+ type LoginQrResponse struct

+ ExpiresIn int

+ QrCode string

+ type LoginStatus struct

+ Authenticated bool

+ type MessageDeleteRequest struct

+ MessageId string

+ Msisdn string

+ type MessageEditRequest struct

+ MessageId string

+ Msisdn string

+ NewMessage string

+ type MessageReactRequest struct

+ Emoji string

+ MessageId string

+ Msisdn string

+ type Option func(*Client)

+ func WithBaseURL(url string) Option

+ func WithHTTPClient(client *http.Client) Option

+ func WithTimeout(timeout time.Duration) Option

+ func WithToken(token string) Option

+ func WithUserAgent(ua string) Option

+ type OutgoingEventMessage string

+ const OutgoingEventMessageMessageFailed

+ const OutgoingEventMessageMessageQueued

+ const OutgoingEventMessageMessageSent

+ type OutgoingWebhookPayload struct

+ Event OutgoingEventMessage

+ JobId string

+ MessageId string

+ Metadata *map[string]interface{}

+ PhoneNumber string

+ Timestamp int

+ To string

+ type RegisterRequest struct

+ PhoneNumber string

+ SecretKey string

+ type RegisterResponse struct

+ Token string

+ type SDKError struct

+ Code int

+ Message string

+ func NewSDKError(code int, message string) *SDKError

+ func (e *SDKError) Error() string

+ func (e *SDKError) Is(target error) bool

+ type SendMessageResponse struct

+ MessageId string

+ Success bool

+ type SendMessageTextRequest struct

+ Message string

+ Msisdn string

+ type SuccessResponse struct

+ Success bool

+ type WebhookRegisterRequest struct

+ HmacSecret *string

+ Url string

+ type WebhookResponse struct

+ URL string

+ type WebhookVerifier struct

+ func NewWebhookVerifier(secret string) *WebhookVerifier

+ func (v *WebhookVerifier) ParseIncomingWebhook(payload []byte, signature string) (*IncomingWebhookPayload, error)

+ func (v *WebhookVerifier) ParseOutgoingWebhook(payload []byte, signature string) (*OutgoingWebhookPayload, error)

+ func (v *WebhookVerifier) VerifySignature(payload []byte, signatureHeader string) bool

v0.1.1

Apr 17, 2026

v0.1.0

Apr 15, 2026

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL